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intro 

introduction to network maintenance and operation 
commands 

Description 

This section contains information related to network operation and 
maintenance. It describes a variety. of commands: slink, to bring up 
the transport; ifconfig , and slattach , to configure network interfaces; 
ping, to test status of remote hosts; trpt, to display packet-tracing in- 
formation; to invoke network services; and and other network 
administration functions. 
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arp 



address resolution display and control 

Syntax 

arp hostname 

arp -a [ namelist ] [ coref ile ] 

arp -d hostname 

arp -s hostname ether_addr [ temp ] [ pub ] [ trail ] 

arp -f filename 

Description 

The arp program displays and modifies the Intemet-to-Ethemet 
address-translation table, which is normally maintained by the 
address-resolution protocol (arp(ADMP)). 

When hostname is the only argument, arp displays the current ARP 
entry for hostname. The host may be specified by name or number, 
using Internet dot notation. [See hosts{PJyMS^) and mer(ADMP).] 

Options are interpreted as follows: 

-a [ namelist ] [ corefile ] 

Display all of the current ARP entries by reading the table from the 
file corefile (default /dev/kmem) based on the kernel file namelist 
(default /unix). 

-d Delete an entry for title host whose name is hostname . (This can be 
performed only by the super user.) 

-s hostname ether _addr [ temp ] [ pub ] [ trail ] 

Create an ARP entry for the host whose name is hostname with the 
Ethernet address ether addr. The Ethernet address is given as six 
colon-separated, two-digit hexadecimal numbers. The entry will 
be permanent unless the argument temp is specified on the com- 
mand line. If pub is specified, the entry will be published: that is, 
this system will act as an ARP server, responding to requests for 
hostname even though the host address is not an address of the 
local host. If trail is specified, trailer encapsulations are to be used 
with this host. N.B. Trailers are a link-dependent issue. Currently, 
no known LLI-compliant ethemet driver suppports trailers, and it 
is unwise to advertise them, unless it is certain that the link layer 
can handle them. 
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-f filename 

Read the file filename and set multiple entries in the ARP tables. 
Entries in the file should be of the form: 



hostname ether _addr [ temp ] [ pub ] [ trail ] 
with argument meanings as given above. 

See Also 

inet(SLIB), arp(ADMP), ifconfig(ADMN). 
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drvconf 

configure TCP/IP ethernet drivers 

Syntax 

/etc/drvconf 

Description 

/etc/drvconf is used to configure TCP/IP to use a particular ethernet 
driver. It prompts with a list of possible drivers and asks the user to 
select one. The TCP/IP configuration files /etc/strcf and /etc/tcp are 
then modified to use the appropriate driver. The driver must be 
installed on the system when drvconf is run. 

See Also 

strcf(SFF), tcp(ADMN), idmknod(ADMN). 

Bugs 

As distributed, this command only supports drivers for the AT/386. 
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fingerd 

remote user information server 

Syntax 

/etc/fingerd 

Description 

fingerd is a server that provides a network interface to the/i«ger(TC) 
program (or, on some other systems, the name program). This inter- 
face 2M0VJS finger to display information about remote users. 

fingerd listens for TCP connections on the finger port. (See 
services(SFF).) For each connection, fingerd reads a single input line 
(terminated by a <CRLF>), passes the line to finger, and copies the 
output of finger to the user on the client machine. 

fingerd is started by the super-server inetd, and therefore must have an 
entry in inetd 's configuration file /etc/inetd.conf. [See inetd (ADMM) 
and inetd.conf (SFF).] 

For it to work, fingerd needs to have a /usr/local/bin directory created 
and then linked to /usr/bin/finger. 

See Also 

fmger(TC), inetd(ADMN), inetd.conf(SFF), services(SFF), RFC 742. 

Warning 

Connecting to fingerd using TELNET (see telnet (TC)) can have 
unpredictable consequences and is not recommended. 
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ftpd 



DARPA Internet File Transfer Protocol server 
Syntax 



/etc/ftpd [ -d ] [ -1 ] [ -itimeout ] 

Description 



ftpd is the DARPA Internet File Transfer Protocol server process. The 
server uses the TCP protocol and listens at the port specified in the ftp 
service specification; see services(SFF). 

ftpd is started by the super-server inetd, and therefore must have an 
entry in inetd 's configuration file /etc/inetd.conf. [See inetd(ADMN) 
and inetd.conf(SFF).] 

If the -d option is specified, debugging information is written to the 
syslog. 

If the -1 option is specified, each FTP session is logged in the syslog. 

The FTP server will timeout an inactive session after 15 minutes. If 
the -t option is specified, the inactivity timeout period will be set to 
timeout. 

The FTP server currently supports the following FTP requests; case is 
not distinguished. 



Request 


Description 


ABOR 


abort previous command 


ACCT 


specify account (ignored) 


ALLO 


allocate storage (vacuously) 


APPE 


append to a file 


CDUP 


change to parent of current working directory 


CWD 


change working directory 


DELE 


delete a file 


HELP 


give help informaticm 


LIST 


give list files in a directory (Is -1) 


MKD 


make a directory 


MODE 


specify data transfer mode 


NLST 


give name list of files in directory (Is) 


NOOP 


do nothing 


PASS 


specify password 


PASV 


prepare for server-to-server transfer 


PORT 


specify data connection port 


PWD 


print the current working directory 


QUIT 


terminate session 
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1 FT 


RETR 


retrieve a file 


RMD 


remove a directory 


RNFR 


specify rename-from file name 


RNTO 


specify rename-to file name 


STOR 


store a file 


STOU 


store a file with a unique name 


STRU 


specify data transfer structure 


TYPE 


specify data transfer type 


USER 


specify user name 


XCUP 


change to parent of current v^'orking directory 


XCWD 


change working directory 


XMKD 


make a directory 


XPWD 


print the current working directory 


XRMD 


remove a directory 



FTPD(ADMN) 



The remaining FTP requests specified in Internet RFC 959 are recog- 
nized, but not implemented. 

The FTP server will abort an active file transfer only when the ABOR 
command is preceded by a Telnet Interrupt Process (IP) signal and a 
Telnet Synch signal in the command Telnet stream, as described in 
Internet RFC 959. 

ftpd interprets file names according to the globbing conventions used 
by sh{C). This allows users to utilize the metacharacters *?[]{}". 

ftpd authenticates users according to three rules. 

1) The user name must be in the password data base /etc/passwd and 
not have a null password. In this case, a password must be pro- 
vided by the client before any file operations can be performed. 

2) The user name must not appear in the file /etc/ftpusers. 

3) If the user name is anonymous or ftp, an anonjmious ftp account 
must be present in the password file (user ftp). In this case, the 
user is allowed to log in by specifying any password. (By conven- 
tion, this is given as 5ie client host's name.) 

In the last case, ftpd takes special measures to restrict the client's 
access privileges. The server performs a chroot(2) command to the 
home directory of the ftp user. To make sure system security is not 
breached, it is recommended that the ftp subtree be constructed with 
care; the following rales are recommended. (Note: ~ftp means "the 
home directory of user ftp") 

-ftp) 

Make it so the home directory is owned by ftp and unwritable by 
anyone. 
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~ftp/bin) 

Make it so this directory is owned by the superuser and unwritable 
by anyone. The program /5(C) must be present to support the list 
commands. This program should have mode 111. 

~ftp/etc) 

Make it so this directory owned by the superuser and unwritable by 
anyone. The files passwd(SFF) and group (SFF) must be present 
for the Is command to work properly. These files should be mode 

444. 

-ftp/pub) 

Make this directory mode 777 and owned by f^. Users should 
then place files that are to be accessible via the anonymous 
account in this directory. 

See Also 

ftp(TC), syslog(SLIB) 

Notes 

The anonymous account is inherently dangerous and should avoided 
when possible. 

The server must run as the superuser to create sockets with privileged 
port numbers. It maintains an effective user id of the logged in user, 
reverting to the superuser only when bindmg addresses to sockets. 
The possible security holes have been extensively scrutinized, but are 
possibly incomplete. 

Files 

/etc/ftpusers - restricted user list 
/etc/passwd - the user database 
/etc/group - the group database 
Aisr/adm/syslog - the system log file 

The following files are needed for anonymous ftp: 

~ftp/etc/passwd - used by ~ftp/bin/ls 

"ftp/etc/group - used by ~ftpA)inAs 

~fQ)/bin/ls - to support the LIST and NLST commands 

In addition, if your /bin/Is is linked with shared libraries, you will need 
to copy /shlib/libc_s to ~ftp/shlib/libc_s. If your implementation is 
using the SIOCSOCKSYS ioctl, you will need to run the 
mdnod{ADMN) command on ~ftp/dev/socksys. 
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hostname _^_^ 

Set or print name of current host system 

Syntax 

hostname [ nameofhost ] 

Description 

The hostname command prints the name of the current host, as given 
before the log-in prompt. The super user can set the hostname by giv- 
ing an argument; this is usually done at boot time in a startup script. 

See Also 

gethostname(SLIB), sethostname(SLIB), uname(C) 
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ifconfig 

configure network interface parameters 

Syntax 

/etc/ifconfig interface address_family [ address [ dest_address ] ] 
[ parameters ] 

/etc/ifconfig interface [ protocol_family ] 

Description 

ifconfig is used to assign an address to a network interface and/or con- 
figure network interface parameters; it defines the network address of 
each interface present on a machine, ifconfig is run at system start-up 
time via tcp(lM). ifconfig may be run at other times to redefine an 
interface's address or ofiier operating parameters. (For example, 
slattach (ADMN) also runs ifconfig .) 

The interface parameter is a string of the form "name unit", for exam- 
ple, "enO". 

Since an interface may receive transmissions in differing protocols, 
each of which may require a separate naming scheme, it is necessary 
to specify the address_family, which may change the interpretation of 
the remaining parameters. Currently, only the Internet address family 
is supported: thus, the only valid value for address_family is inet. 

For the DARPA-Intemet family, the address is either a host name or a 
DARPA Internet address expressed in the Internet standard "dot nota- 
tion". (Host name translation is performed either by the name server 
or by an entry in /etc/hosts. [See name<i(ADMN) and /zc»5'r5(ADMN).] 
Internet "dot notation" is described in hosts {ADMH) and 
fnef (ADMP). Other address families may use different notations.) 

The following parameters may be set with ifconfig : 

up Mark an interface "up". This may be used to enable 

an interface after an "ifconfig down". It happens 
automatically when setting the first address on an 
interface. If the interface was reset when previ- 
ously marked down, the hardware will be re- 
initialized. 
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down 



detach 



trailers 



-trailers 
arp 



Mark an interface "down". When an interface is 
marked "down", the system will not attempt to 
transmit messages through that interface. If possi- 
ble, the interface will be reset to disable reception 
as well. This action does not automatically disable 
routes using the interface. 

Remove an interface from the system. This com- 
mand is applicable to transient interfaces only, such 
as serial line interfaces. 

Request the use of a trailer link level encapsulation 
when sending (default). If a network interface sup- 
ports trailers, the system will, when possible, 
encapsulate outgoing messages in a manner that 
minimizes the number of memory-to-memory copy 
operations performed by the receiver. On networks 
that support the Address Resolution Protocol (see 
arp(ADMPy, currently, only 10 Mb/s Ethernet), this 
flag indicates that the system should request that 
other systems use trailers when sending to this host. 
Similarly, trailer encapsulations will be sent to 
other hosts that have made such requests. This is 
currently used by Internet protocols only. 

Disable the use of a trailer-link-level encapsulation. 

Enable the use of the Address Resolution Protocol 
in mapping between network level addresses and 
link-level addresses (default). This is currently 
implemented for mapping between DAEPA Internet 
addresses and lOMb/s Ethernet addresses. This 
option is not applicable in the STREAMS environ- 
ment. Use of arp for an interface is specified in 
/etc/strcf. The arp driver will be opened when the 
STREAMS stack is built. 



-arp 
metric n 



debug 
-debug 



Disable the use of the Address Resolution Protocol. 

Set the routing metric of the interface to n, default 
0. The routing metric is used by the routing proto- 
col. Higher metrics have the effect of making a 
route less favorable; metrics are counted as addition 
hops to the destination network or host. 

Enable driver-dependent debugging code; usually, 
this turns on extra console error logging. 

Disable driver-dependent debugging code. 
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netmask mask 



dstaddr 



broadcast 



onepacket 



-onepacket 



(Inet only) Specify how much of the address to 
reserve for subdividing networks into sub-networks. 
The mask mcludes the network part of the local 
address and the subnet part, which is taken from the 
host field of the address. The mask can be specified 
as a single hexadecimal number with a leading Ox, 
with a dot-notation hitemet address, or with a 
pseudo-network name listed in the network table 
networks(SFF). The mask contains I's for the bit 
positions in the 32-bit address, which are to be used 
for the network and subnet parts, and O's for the 
host part. The ihask should contain at least the 
standard network portion, and the subnet field 
should be contiguous with the network portion. 

Specify the address of the correspondent on the 
other end of a point-to-point link. 

(Inet only) Specify the address to use to represent 
broadcasts to the network. The default broadcast 
address is the address with a host part of all 1 's. 

Enable the one-packet mode of operation (used for 
interfaces that cannot handle back-to-back packets) 
The keyword onepacket must be followed by two 
numeric parameters, giving the small packet size 
and threshold, respectively. If small packet detec- 
tion is not desired, these values should be zero. See 
/cp(ADMP) for an explanation on one-packet mode. 

Disable one-packet mode. 



ifconfig displays the current configuration for a network interface 
when no optional parameters are supplied. If a protocol family is 
specified, ifconfig will report only the details specific to that protocol 
family. 

Only the supemser may modify the configuration of a network inter- 
face. 

Diagnostics 

Messages indicating the specified interface does not exit, the 
requested address is unknown, or the user is not privileged and tried to 
alter an interface's configuration. 

Files 
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/etc/slattach 

calls ifconfig to start serial lines 

See Also 

arp(ADMN), tcp(ADMN), netstat(TC), hosts(SFF), networks(SFF), 
strcf(ADMN), arp(ADMP), tcp(ADMP). 
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inetd 

internet super server 

Syntax 

/etc/inetd [ -d ] [ configuration file ] 

Description 

inetd listens on multiple ports for incoming connection requests. 
When it receives a request, it spawns the appropriate server. The use 
of a superserver allows other servers to be spawned only when needed 
and to terminate when they have satisfied a particular request. 

The mechanism is as follows: inetd is started by the superuser (usu- 
ally during init 2, if /etc/top is linked to /etc/rc2.d/S7intcp.). To 
obtain information about the servers it needs to spawn, inetd reads its 
configuration file (by default, letclinetd.conf(S¥¥)) and issues a call to 
getservbyname . [See getservent (SLIB).] (Note that /etc/services and 
/etc/protocols must be properly configured.) inetd then creates a 
socket for each server and binds each socket to the port for that server. 
It does a listen (SSC) on all connection-based sockets (that is, stream 
rather than datagram), and waits, using select (S^C), for a connection 
or datagram. 

• When a connection request is received on a listening (stream) 
socket, inetd does an accept {SSC), thereby creating a new socket. 
{inetd continues to listen on the original socket for new requests). 
inetd forks, dups, and execs the appropriate server, passing it any 
server program arguments specified in inetd 's configuration file. 
The invoked server has I/O to stdin, stdout, and stderr done to the 
new socket; this connects the server to the client process. (Some 
built-in, internal services are performed via function calls rather 
than child processes.) 

• When there is data waiting on a datagram socket, inetd forks, dups, 
and execs the appropriate server, passing it any server program 
arguments; unlike a connection-based server, a datagram server 
has I/O to stdin, stdout, and stderr done to the original socket. If 
the datagram socket is marked as wait (which corresponds to an 
entry in inetd 's configuration file), the invoked server must process 
the message before inetd considers the socket available for new 
connections. If the datagram socket is marked as nowait, inetd 
continues to process incoming messages on that port, tftpd is an 
exceptional case: although its entry in inetd 's configuration file 
must be wait (to avoid contention for the port), inetd is able to con- 
tinue processing new messages on the port. 
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The following servers may be started by inetd: fingerd , ftpd , rexecd, 
rlogind, rshd, te Inetd, and tftpd. inet must also start several internal 
services: these are described in inetd.conf(SFF). Do not arrange for 
inetd to start rwhod, or any NFS server. 

inetd rereads its configuration file when it receives a hangup signal, 
SIGHUP. Services may be added, deleted or modified when the con- 
figuration file is reread. 

The -d option turns on socket-level debugging and prints debugging 
information to stdout. 

Files 

/etc/inetd.conf 

/etc/protocols 

/etc/services 

See Also 

fingerd(ADMN), ftpd(ADMN), rexecd(ADMN), rlogind(ADMN), 
rshd(ADMN), telnetd(ADMN), tftpd(ADMN), inetd.conf(SFF), 
protocols(SFF), services(SFF). 



August 1,1989 INETD-2 



LDSOCKET(ADMN) LDSOCKET (ADMN) 

Idsocket ^^^ 

load socket configuration 
Syntax 

Idsocket [-v] [-c file] 

Description 

Idsocket initializes the System V STREAMS TCP/IP Berkeley network- 
ing compatability interface, which is an alternate stream head support- 
ing the socket {SSC) system call family. Idsocket loads the kernel with 
associations between the protocol family, type and number triplets 
passed to the socket system call, and the STREAMS devices supporting 
those protocols. Idsocket reads the file /etc/sockcf to obtain con- 
figuration information, and must be run before the Berkeley network- 
ing interface can be used. 

The following options may be specified on the Idsocket command 
line: 

-cfile Use ^/e instead of /etc/sockcf. 

-V Use verbose mode (in which a message is written to stderr 

for each protocol loaded). 

Files 

/etc/sockcf 

See Also 

sockcf(SFF), intro(ADMP), socket(SSC). 



July 15, 1989 LDSOCKET-1 



LMAIL(ADMN) LMAIL(ADMN) 

Imail 

handle local mail delivery from sendmail 

Syntax 

Imail user ... 

Description 

Imail interprets incoming mail received from sendmail (ADh/iN), and 
delivers it to the specified user on the local machine. It locks the 
user's mailbox using the mail (IC) locking mechanism. 

See Also 

mail(TC), sendmail(ADMN). 
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mailaddr 

mail addressing description 

Description 

Mail addresses are based on the ARPANET protocol listed at the end 
of this manual page. These addresses are in the general format 

user@domain 

where a domain is a hierarchical dot separated list of subdomains. For 
example, the address 

stevea@laiter.lachman.com 

is normally interpreted from right to left: the message should go to the 
Lachman gateway, after which it should go to the local host laiter. 
When the message reaches laiter it is delivered to the user "stevea". 

Unlike some other forms of addressing, this does not imply any rout- 
ing. Thus, although this address is specified as an RFC822 address, it 
might travel by an alternate route if tiiat were more convenient or effi- 
cient. For example, at Lachman, the associated message would prob- 
ably go directly to laiter over the Ethernet rather than going via the 
Lachman mail gateway. 

Abbreviation. 

Under certain circumstances it may not be necessary to type the entire 
domain name. In general, anything following the first dot may be 
omitted if it is the same as the domain from which you are sending the 
message. For example, a user on "laisagna.Lachman.COM" could 
send to "stevea@ laiter" without adding the "Lachman.COM" since it 
is the same on both sending and receiving hosts. 

Certain other abbreviations may be permitted as special cases. For 
example, at Lachman, Internet hosts may be referenced without add- 
ing the "Lachman.COM" as long as their names do not conflict with a 
local host name. 

Compatibility. 

Certain old address formats are converted to the new format to provide 
compatibility with the previous mail system. In particular, 

user(a)host.ARPA 
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is allowed and 

host: user 
is converted to 

user@host 
to be consistent with the rcp(l) command. 
Also, the syntax 

host! user 



is converted to: 



user@host.UUCP 



This is normally converted back to the "host! user" form before being 
sent on for compatibility with older UUCP hosts. 

The current implementation is not able to route messages automatical - 
ly through the UUCP network. Until that time you must explicitly tell 
the mail system which hosts to send your message through to get to 
your final destination. 

Case Distinctions. 

Domain names (i.e., anything after the "@" sign) may be given in any 
mixture of upper and lower case with the exception of UUCP host- 
names. Most hosts accept any combination of case in user names, 
with the notable exception of MUUTICS sites. 

Route-addrs. 

Under some circumstances it may be necessary to route a message 
through several hosts to get it to the final destination. Normally this 
routing is done automatically, but sometimes it is desirable to route 
the message manually. Addresses which show these relays are termed 
"route-ad^s." These use the syntax: 

<@hosta,@hostb:user@hostc> 

This specifies that the message should be sent to hosta, from there to 
hostb, and finally to hostc. Tliis path is forced even if ttiere is a more 
efficient path to hostc. 

Route-addrs occur frequently on return addresses, since these are gen- 
erally augmented by the software at each host. It is generally possible 
to ignore all but the "user@domain" part of the address to determine 
the actual sender. 
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Postmaster. 

Every site is required to have a user or user alias designated "post- 
master" to which problems with the mail system may be addressed. 

Other Networks. 

Some other networks can be reached by giving the name of the net- 
work as the last component of the domain. This is not a standard fea- 
ture and may not be supported at all sites. For example, messages to 
CSNET or BITNET sites can often be sent to "user@host.CSNET" or 
"user@host.BITNET" respectively. 

Bugs 

The RFC822 group sjoitax ("group:userl,user2,user3;") is not sup- 
ported except in the special case of "group:;" because of a conflict 
with old berknet-style addresses. 

Route-Address syntax is ugly. 

UUCP- and RFC822-style addresses do not coexist politely. 

See Also 

mailx(TC), sendmail(ADMN). RFC822. 
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mconnect 

connect to SMTP mail server socket 

Syntax 

mconnect [ -p port ] [ -r ] [ hostname ] 

Description 

Mconnect opens a connection to the mail server on a given host, so 
that it can be tested independently of all other mail software. If no 
host is given, the connection is made to the local host. Servers expect 
to speak the Simple Mail Transfer Protocol (SMTP) on this connec- 
tion. Exit by typing the "quit" command. Typing end-of-file will 
cause an end of file to be sent to the server. An interrupt closes the 
connection immediately and exits. 

Options 



-p Specify the port number instead of the default SMTP port (number 
25) as the next argument. 

-r "Raw" mode: disable the default line buffering and input handling. 
This gives you a similar effect as telnet to port number 25, not 
very useful. 



Files 



/usrAib/sendmail.hf Help file for SMTP commands 

See Also 



sendmail( ADMN) . 
RFC821. 
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mkhosts 

make node name commands 

Syntax 

/etc/mkhosts 

Description 

mkhosts makes the simplified forms of the rcmd(TC) and rlogin(TC) 
commands. For each node Usted in /etc/hosts, mkhosts creates a link 
to /usr/bin/rcmd in /usr/hosts. Each link's name is the same as the 
node's official name in /etc/hosts. 

See Also 



rcmd (TC), rlogin(TC). 
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named 

Internet domain name server 

Syntax 

named [ -d debuglevel ] [ -p port# ] [ -b bootfile ] 

Description 

named is the Internet domain name server. (See RFC1035 for more 
details on the Internet name-domain system.) Without any arguments, 
named will read the default boot file /etc/named.boot, read any initial 
data, and listen for queries. 

Options are: 

-d Print debugging information. A number after the d determines the 
level of messages printed. 

-p Use a different port mrniber. The default is the standard port num- 
ber as listed in /etc/services. 

-b Use an alternate boot file. This is optional and allows you to 
specify a file with a leading dash. 

Any additional argument is taken as the name of the boot file. The 
boot file contains information about where the name server is to get its 
initial data. If multiple boot files are specified, only the last is used. 
Lines in the boot file cannot be continued on subsequent lines. The 
following is a small example: 

; boot file for name server 

directory /usr/iocal/lib/named 

; type domain source host/file backup file 

cache rootcache 

primary Beri^eley.EDU berkeley.edu.zone 

primary 32.128.IN-ADDR.ARPA ucbhosts.rev 

secondary CC.Berkeley.EDU 128.32.137.8 128.32.137.3 cc.zone.bak 

secondary 6.32.1 28.IN-ADDR.ARP A 128.32.137.8 128.32.137.3 ccrev.bak 
primary 0.0.1 27.IN-ADDR.ARPA localhostrev 

forwarders 10.0.0.78 10.2.0.78 
; slave 
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The "directory" line causes the server to change its working directory 
to the directory specified. This can be important for the correct pro- 
cessing of $INCLUDE files in primary zone files. 

The "cache" line specifies that data in "root.cache" is to be placed in 
the backup cache. Its main use is to specify data such as locations of 
root domain servers. This cache is not used during normal operation, 
but is used as "hints" to find the current root servers. The file 
"root.cache" is in the same format as "berkeley.edu.zone". There can 
be more than one "cache" file specified. The cache files are processed 
in such a way as to preserve the time-to-live 's of data dumped out. 
Data for the root nameservers is kept artificially valid if necessary. 

The first "primary" line states that the file "berkeley.edu.zone" con- 
tains authoritative data for the "Berkeley.EDU" zone. The file 
"berkeley.edu.zone" contains data in the master file format described 
in RFC1035. All domain names are relative to the origin, in this case, 
"Berkeley.EDU" (see below for a more detailed description). The 
second "primary" line states that the file "ucbhosts.rev" contains 
authoritative data for the domain "32.128.IN-ADDR.ARPA," which is 
used to translate addresses in network 128.32 to hostnames. Each 
master file should begin with an SOA record for the zone (see below). 

The first "secondary" line specifies that all authoritative data under 
"CC.Berkeley.EDU" is to be transferred from the name server at 
128.32.137.8. If the transfer fails it will try 128.32.137.3 and continue 
trying the addresses, up to 10, listed on this line. The secondary copy 
is also authoritative for the specified domain. The first non-dotted- 
quad address on this line will be taken as a filename in which to 
backup the transferred zone. The name server will load the zone from 
this backup file if it exists when it boots, providing a complete copy 
even if the master servers are unreachable. Whenever a new copy of 
the domain is received by automatic zone transfer from one of the 
master servers, this file will be updated. The second "secondary" Ime 
states that the address-to-hostname mapping for the subnet 128.32.136 
should be obtained from the same list of master servers as the previous 
zone. 

The "forwarders" line specifies the addresses of sitewide servers that 
will accept recursive queries from other servers. If the boot file 
specifies one or more forwarders, then the server will send all queries 
for data not in the cache to the forwarders fiirst. Each forwarder will 
be asked in turn until an answer is returned or the list is exhausted. If 
no answer is forthcoming from a forwarder, the server will continue as 
it would have without the forwarders line unless it is in "slave" mode. 
The forwarding facility is useful to cause a large sitewide cache to be 
generated on a master, and to reduce traffic over links to outside 
servers. It can also be used to allow servers to run that do not have 
access directly to the Internet, but wish to act as though they do. 
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The "slave" line (shown commented out) is used to put the server in 
slave mode. In this mode, the server will only make queries to for- 
warders. This option is normally used on machine that wish to run a 
server but for physical or administrative reasons cannot be given 
access to the Internet, but have access to a host that does have access. 

The "sortlist" line can be used to indicate networks that are to be pre- 
ferred over other, unlisted networks. Queries for host addresses from 
hosts on the same network as the server will receive responses with 
local network addresses listed first, then addresses on the sort Ust, then 
other addresses. This line is only acted on at initial startup. When 
reloading the nameserver with a SIGHUP, this line will be ignored. 

The master file consists of control information and a list of resource 
records for objects in the zone of the forms: 

$INCLUDE <filename> <opt_domain> 

$ORIGIN <domain> 

<domaiii> <opt_ttl> <opt_class> <type> <resource_record_data> 

where domain is ". " for root, "@" for the current origin, or a standard 
domain name. If domain is a standard domain name 5iat does not end 
with ".", the current origin is appended to the domain. Domain names 
ending with "." are unmodified, opt domain field is used to define an 
origin for the data in an included file. It is equivalent to placing a 
$ORIGIN statement before the first line of the included file. The field 
is optional. Neither the opt domain field nor $ORIGIN statements in 
the included file modify the current origin for this file. The optjtl 
field is an optional integer number for the time-to-live field. It 
defaults to zero, meaning the minimum value specified in the SOA 
record for the zone. The optclass field is the object address type; 
currently only one type is supported, IN, for objects connected to the 
DARPA Internet. The type field contains one of the following tokens; 
the data expected in the resource _record_data field is in parentheses. 

A a host address (dotted quad) 

NS an authoritative name server (domain) 

CNAME the canonical name for an alias (domain) 

SOA marks the start of a zone of authority (domain of originating 
host, domain address of maintainer, a serial number and the 
following parameters in seconds: refresh, retry, expire and 
minimum TTL (see RFC 1035)) 

MB a mailbox domain name (domain) 

MG a mail group member (domain) 
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MR a mail rename domain name (domain) 

MX a mail exchange record 

NULL a null resource record (no format or data) 

WKS a well-known service description (not implemented yet) 

PTR a domain name pointer (domain) 

HINFO host information (cpu_type OS_type) 

MINFO mailbox or mail list information (request_domain 
error_domain) 

Resource records normally end at the end of a line, but may be contin- 
ued across lines between opening and closing parentheses. Comments 
are introduced by semicolons and continue to ttie end of the line. 

Each master zone file should begin with an SOA record for the zone. 
An example SOA record is as follows: 

@ IN SOA ucbvax.Berkeley.EDU. rwh.ucbvax.Berkeley.EDU. ( 
2.89 ; serial 
10800; refresh 
3600 ; retry 
3600000 ; expire 
86400 ) ; minimum 

The SOA lists a serial number, which should be changed each time the 
master file is changed. Secondary servers check the serial number at 
intervals specified by the refresh time in seconds; if the serial number 
changes, a zone transfer will be done to load the new data. If a master 
server cannot be contacted when a refresh is due, the retry time 
specifies the interval at which refreshes should be attempted until suc- 
cessful. If a master server cannot be contacted within the interval 
given by the expire time, all data from the zone is discarded by sec- 
ondary servers. The minimum value is the time-to-live used by 
records in the file with no explicit time-to-live value. 

Notes 

The boot file directives "domain" and "suffixes" have been obsoleted 
by a more useful resolver based implementation of suffixing for par- 
tially qualified domain names. The prior mechanisms could fail under 
a number of situations, especially when then local nameserver did not 
have complete information. 

The following signals have the specified elBfect when sent to the server 
process using the kill{C) command. 
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SIGHUP Causes server to read named.boot and reload database. 

SIGINT Dumps current data base and cache to 
/usr/tmp/named_dump.db. 

SIGIOT Dumps statistics data into /usr/tmp/named.stats if the 
server is compiled -DSTATS. Statistics data is appended 
to the file. 

SIGSYS Dumps the profiling data in Aisr/tmp if the server is com- 
piled with profiling (server forks, chdirs and exits). 

SIGTERM Dumps the primary and secondary database files. Used to 
save modified data on shutdown if the server is compiled 
with dynamic updating enabled. 

SIGUSRl Turns on debugging; each SIGUSRl increments debug 
level. 

SIGUSR2 Turns off debugging completely. 

Files 

/etc/named.boot name server configuration boot file 

/etc/named.pid the process id 

Aisr/tmp/named.run debug output 

/usr/tmp/named_dump.db dump of the name servers database 

/usr/tmp/named.stats nameserver statistics data 

See Also 

kill(C), gethostent(SLIB), signal(S), sigset(S), resolver(SFF), 

resolver(AI)MN), hostname(ADMP). 

RFC974, RFC 1034, RFC 1035, Name Server Operations Guide for 

BIND. 
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netlogin 

network login program 
Syntax 

netlogin [ -p ] [ -r remotehost ] [ name ] [ env-var ] 

Description 

Netlogin is a derivative of the login(TC) command. It provides facili- 
ties that telnetd(ADMN) and rlogind(ADMN) need, such as preserving 
the environment, and support for automatically logging users in. 
Netlogin takes the following options: 

-p Preserve the environment. This is used by telnetd to pass informa- 
tion obtained via terminal type negotiation. 

-r remotehost 

Process automatic login from remotehost. Used by rlogind to 
allow a user with the proper permissions to bypass the password 
prompt when logging in. 

See Also 

login(TC), rlogind(ADMN), telnetd(ADMN), rhosts(SFF). 
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ping 

send ICMP ECHO_REQUEST packets to network 
hosts 

Syntax 

/etc/ping [ -r ] [ -V ] host [ packetsize ] [ count ] 

Description 

ping is a troubleshooting tool for tracking a single-point hardware or 
software failure in the Internet. It uses Sie ICMP protocol's manda- 
tory ECHO_REQUEST datagram to elicit an ICMP 
ECHO.RESPONSE from a host or gateway. ECHO_REQUEST 
datagrams ( pings) have an IP and an ICMP header, followed by a 
struct timeval and an arbitrary number of pad bytes used to fill out 
the packet. Default datagram length is 64 bytes, but this may be 
changed using the command-line option. Other options are: 

-r Bypass the normal routing tables and send directly to a host on an 
attached network. If the host is not on a directly-attached network, 
an error is returned. This option can be used to ping a local host 
through an interface that has no route through it. 

-V Verbose output. ICMP packets other than ECHO RESPONSE that 
are received are listed. 

When using ping for fault isolation, it should first be run on the local 
host, to vertfy that the local network interface is up and running. 
Then, hosts and gateways further and further away should be pinged. 
The ping tool sends one datagram per second, and prints one line of 
output for every ECHO_RESPONSE returned. No output is produced 
if there is no response. If an optional count is given, only that number 
of requests is sent. Round-trip times and packet loss statistics are 
computed. When all responses have been received or the program 
times are out (with a count specified), or if the program is terminated 
with a SIGINT, then a brief summary is displayed. 

This program is intended for use in network testing, measurement and 
management. It should be used primarily for manual fault isolation. 
Because of the load it could impose on the network, it is unwise to use 
ping during normal operations or from automated scripts. 

See Also 

netstat(TC), ifconfig(ADMN). 
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rdate 

notify time server that date lias changed 

Syntax 

rdate 

Descrlptian 

rdate notifies //weJ(ADMN) that the system date has changed. If the 
local time server is a master, it will notify all of the slaves that the 
time has changed. If it is a slave, it will ask the master to update the 
time. 

rdate should be run whenever the super user sets the date with 
date(C). A shell script such as the following could be used to do both 
automatically. 



mv /bin/date /bin/s5date 
install as /bin/date 

PATH=/bin:/usr/bin 
sSdate $* 
rdate 



See Also 

date(C), adjtime(SSC), gettimeofday(SLIB), icmp(ADMP), 
timed(ADMN), timedc(ADMN). 
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rexecd 

remote execution server 
Syntax 

/etc/rexecd 

Description 

rexecd is the server for the rexec (SLIB) routine. The server provides 
remote execution facilities with authentication based on user names 
and passwords. 

rexecd listens for service requests at the port indicated in the exec ser- 
vice specification; see services {SF¥). When a service request is 
received, the following protocol is initiated: 

1) The server reads characters from the socket up to a null CNO') byte. 
The resultant string is interpreted as an ASCII number, base 10. 

2) If the number received in step 1 is non-zero, it is interpreted as the 
port number of a secondary stream to be used for the stderr. A 
second connection is then created to the specified port on the 
client's machine. 

3) A null-terminated user name of at most 16 characters is retrieved 
on the initial socket. 

4) A null-terminated, unencrypted password of at most 16 characters 
is retrieved on the initial socket. 

5) A null-terminated command to be passed to a shell is retrieved on 
the initial socket. The length of the command is limited by the 
upper bound on the size of the system's argument list. 

6) Then, rexecd validates the user as is done at login time and, if the 
authentication was successful, changes to the user's home direc- 
tory, and establishes the user and group protections of the user. If 
any of these steps fail, the connection is aborted with a diagnostic 
message returned. 

7) A null byte is returned on the initial socket and the command line 
is passed to the normal login shell of the user. The shell inherits 
the network connections established by rexecd. 

rexecd is started by the super-server inetd, and therefore must have an 
entry in inetd' s configuration file /etc/inetd.conf. 
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Diagnostics 

Except for the last one listed below, all diagnostic messages are 
returned on the initial socket, after which any network connections are 
closed. An error is indicated by a leading byte with a value of 1 . (0 is 
returned in step 7, above, upon successful completion of all the steps 
prior to the command execution.) 

"username too long" 

The name is longer than 16 characters. 

"password too long" 

The password is longer than 16 characters. 

"command too long " 

The command line passed exceeds the size of the argu- 
ment list (as configured into the system). 

"Login incorrect." 

No password file entry for the user name existed. 

"Password incorrect." 

The wrong password was supplied. 

"No remote directory." 

The chdir command to the home directory failed. 

"IVy again." 

A fork by the server failed. 

"<shellname>: ..." 

The user's login shell could not be started. This message 
is returned on the connection associated with the stderr, 
and is not preceded by a flag byte. 

See Also 

rexec(SLIB), inetd(ADMN), inetd.conf(SFF), services(SFF). 

Notes 

Indicating "Login incorrect" as opposed to "Password incorrect" is a 
security breach which allows people to probe a system for users with 
null passwords. 

A facility to allow all data and password exchanges to be encrypted 
should be present. 
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riogind 

remote login server 

Syntax 

/etc/rlogind 

Description 

riogind is a network server that supports remote logins by programs 
such as rlogin(TC). It is started by the superserver inetd and, there- 
fore, must have an entry in inetd 's configuration file /etc/inetd.conf. 
[See mef^(ADMN) and inetd.confiSFF).] 

riogind enforces an authentication procedure based on equivalence of 
user names (see rhosts(SFF)). This procedure assumes all hosts on the 
network are equally secure. 

See Aiso 

inetd(ADMN), rlogin(TC), inetd.conf(SFF), rhosts(SFF), 
services(SFF). 
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rmail 

handle remote mail received via uucp 

Syntax 

rmail user ... 

Description 

rnmil interprets incoming mail received via uucpiC), collapsing 
"From" lines in the form generated by mailiTC) into a single line of 
the form return-path! sender , and passing the processed mail on to 
sendmail (ADMN). 

rmail is explicitly designed for use with uucp and sendmail. 

See Also 

mail(TC), uucp(C), sendmail(ADMN). 
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route 

manually manipulate the routing tables 

Syntax 

/etc/route [ -f ] [ -n ] [ command destination gateway [ metric ] ] 

Description 

route is a program used to manipulate manually the network routing 
tables. It is normally not needed, since the routing daemon routed 
manages the system routing table and therefore handles this function. 

route accepts two commands: add, to add a route; and delete, to 
delete a route. 

All commands have the following syntax: 

/etc/route command destination gateway [ metric ] 

where destination is a host or network for which the route is "to", 
gateway is the gateway to which packets should be addressed, and 
metric is an optional count indicating the number of hops to the desti- 
nation. If no metric is specified, route assumes a value of 0. Routes 
to a particular host are distinguished from those to a network by inter- 
preting the Internet address associated with destination . If the desti- 
nation has a local address part of INADDR_ANY, the route is 
assumed to be to a network; otherwise, it is presumed to be a route to a 
host. Note: If the route is to a destination connected via a gateway, metric 
should be greater than 0. All symbolic names specified for a destina- 
tion or gateway are looked up first in the host-name database; see 
hosts(SFF). If this lookup fails, the name is then looked for in the net- 
work name database; see networks(SFF). 

route uses a raw socket and the SIOCADDRT and SIOCDELRT 
ioctl 's to do its work. Therefore, only the super user may modify the 
routing tables. 

If the -f option is specified, route will flush the routing tables of all 
gateway entries. If this is used in conjunction with one of the com- 
mands described above, the tables are flushed prior to the command's 
application. 

The -n option prevents attempts to print host and network names sym- 
bolically when reporting actions. 
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Diagnostics 

add [ host | network ] 

The specified route is being added to the tables. The values printed 
are from the routing table entry supplied in the ioctl call. 

"delete host', gateway host flags hex-flags^ 

As above, but when deleting an entry. 

^host host done" 

When the -f flag is specified, each routing table entry 
deleted is indicated wifli a message of this form. 

"not in table" 

A delete operation was attempted for an entry which was 
not present in the tables. 

"routing table overflow" 

An add operation was attempted, but the system was low 
on resources and unable to allocate memory to create the 
new entry. 

See Also 

routed(ADMN), intro(ADMN), hosts(SFF), networks(SFF). 
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routed 

network routing daemon 

Syntax 

/etc/routed [-d] [-g] [-s] [-t] [logfile] 

Description 

routed manages the Internet routing tables using a variant of the 
Xerox NS Routing Information Protocol, routed is invoked by the 
superuser (usually during init 2). 

In normal operation, routed listens on the udp(ADMP) socket for the 
route service (see services(SFF)) for routing information packets. If 
the host is an internetwork router, it periodically supplies copies of its 
routing tables to any directly connected hosts and networks. 

When routed is started, it uses the SIOCGIFCONF ioctl to find those 
directly connected interfaces configured into the system and marked 
"up". (The software loopback interface is ignored.) If multiple inter- 
faces are present, it is assumed that the host will forward packets 
between networks. Then, routed transmits a request packet on each 
interface (using a broadcast packet if the interface supports it) and 
enters a loop, listening for request and response packets firom other 
hosts. 

When a request packet is received, routed formulates a reply based on 
the information maintained in its internal tables. The response packet 
generated contains a list of known routes, each marked with a hop 
count metric. (A count of 16 or greater is considered infinite.) The 
metric associated with each route returned provides a metric relative 
to the sender. 

Response packets received by routed are used to update the routing 
tables if one of the following conditions is satisfied: 

(1) 

No routing table entry exists for the destination network or host, 
and the metric indicates the destination is reachable (that is, the 
hop count is not infinite). 

(2) 

The source host of the packet is the same as the router in the exist- 
ing routing table entry. That is, updated information is being 
received from the very internetwork router through which packets 
for the destination are being routed. 
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(3) 

The existing entry in the routing table has not been updated for 
some time (defined to be 90 seconds) and the route is at least as 
cost effective as the current route. 

(4) 

The new route describes a shorter path to the destination than the 
one currently stored in the routing tables; the metric of the new 
route is compared against the one stored in the table to decide this. 

When an update is applied, routed records the change in its internal 
tables and updates the kernel-routing' table. The change is reflected in 
the next response packet sent. 

In addition to processing incoming packets, routed also periodically 
checks the routing table entries. If an entry has not been updated for 3 
minutes, its metric is set to infinity and marked for deletion. Deletions 
are delayed an additional 60 seconds to ensure that the invalidation is 
propagated throughout the local internet. 

Hosts acting as internetwork routers gratuitously supply their routing 
tables every 30 seconds to all directly-connected hosts and networks. 
The response is sent to the broadcast address on nets capable of the 
broadcast function, to the destination address on point-to-point links, 
and to the router's own address on other networks. The normal routing 
tables are bypassed when sending gratuitous responses. The reception 
of responses on each network is used to determine that the network 
and interface are functioning correctly. If no response is received on 
an interface, another route may be chosen to route around the inter- 
face, or the route may be dropped if no alternative is available. 

routed supports several options: 

-d Enable additional debugging information to be logged, such as bad 
packets received. 

-g This flag is used on internetwork routers to offer a route to the 
default destination. This is typically used on a gateway to the 
Internet, or on a gateway that uses another routing protocol whose 
routes are not reported to other local routers. 

-s Supplying this option forces routed to supply routing information 
whether it is acting as an internetwork router or not. This is the 
default if multiple network interfaces are present, or if a point-to- 
point link is in use. 

-q This is the opposite of the -s option. 

-t If the -t option is specified, all packets sent or received are printed 
on the standard output. In addition, routed will not divorce itself 
from the controlling terminal, and so interrupts from the keyboard 
will kill the process. 
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Any other argument supplied is interpreted as the name of file in 
which routed 's actions should be logged. This log contains informa- 
tion about any changes to the routing tables and, if the log is not trac- 
ing all packets, a history of recent messages sent and received that are 
related to the changed route. 

In addition to the facilities described above, routed supports the 
notion of distant passive and active gateways. When routed is started 
up, it reads the file /etc/gateways to find gateways that may not be 
located using only information from the SIOCGIFCONF ioctl . Gate- 
ways specified in this manner should.be marked passive if they are not 
expected to exchange routing information, while gateways marked 
active should be willing to exchange routing information (that is, they 
should have a routed process miming on the machine). Passive gate- 
ways are maintained in the routing tables forever, and information 
regarding their existence is included in any routing information 
transmitted. Active gateways are treated equally with network inter- 
faces. Routing information is distributed to the gateway and, if no 
routing information is received for a period of time, the associated 
route is deleted. External gateways are also passive, but are not 
placed in the kernel routing table nor are they included in routing 
updates. The function of external entries is to inform routed that 
another routing process will install such a route, and that alternate 
routes to that destination should not be installed. Such entries are 
only required when both routers may learn of routes to ttie same desti- 
nation. 

The /etc/gateways is comprised of a series of lines, each in the follow- 
ing format: 

<net I host> name] gateway name! metric va/Me< passive | active | external > 

The net or host keyword indicates whether the route is to a network or 
specific host. 

namel is the name of the destination network or host. This may be a 
symbolic name located in /etc/networks or /etc/hosts (or, if started 
after named(ADMN), known to the name server), or an Internet 
address specified in "dot" notation; see hosts(SFF) and inet(ADMP). 

namel is the name or address of the gateway to which messages 
should be forwarded. 

value is a metric indicating the hop count to the destination host or 
network. 

One of the keywords passive, active and external indicates whether 
the gateway should be treated as passive or active (as described 
above), or the gateway is external to flie scope of the routed protocol. 
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Files 

/etc/gateways for distant gateways 

See Also 

uclp(ADMP). 

Notes 

The kernel's ICMP routing tables may not correspond to those of 
routed when ICMP redirects change or add routes. 
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rshd 

remote shell server 

Syntax 

/etc/rshd 

Description 

rshd is the network server for programs such as rcmd(TC) and 
rep (TC) which need to execute a noninteractive shell on remote ma- 
chines, rshd is started by the superserver inetd, and therefore must 
have an entry in inetd 's configuration file /etc/inetd.conf. [See 
inetd(ADMN) and inetd.confiSFF)]. 

rshd enforces an authentication procedure based on equivalence of 
user names (see rhosts(SFF)). Tliis procedure assumes all nodes on 
the network are equally secure. 

See Also 

inetd(ADMN), rcmd(TC), rcp(TC), inetd.conf(SFF), rhosts(SFF). 
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rwhod 

system status server 

Syntax 

/etc/rwhod 

Description 

rwhod is the server which maintains the database used by the 
rwho(TC) and ruptime (TC) programs. Its operation is predicated on 
the ability to broadcast messages on a network. 

rwhod operates as both a producer and a consumer of status informa- 
tion. As a producer of information, it periodically queries the state of 
the system and constructs status messages that are broadcast on a net- 
work. As a consumer of information, it listens for other rwhod 
servers' status messages, validating them, then recording them in a 
collection of files located in the directory /usr/spool/rwho. 

The server transmits and receives messages at the port indicated in the 
rwho service specification; see services (SFF). The messages sent and 
received are of the form: 



struct 


outmp { 




char 


outJine[8]-/* tty name 7 




char 


out_name[8]y* user id 7 


}; 


long 


out_timey* time on 7 


struct 


whod { 




char 


wd_vers; 




char 


wd type; 




char 


wd_fill[2]; 




int 


wd_sendtime; 




int 


wd recvtime; 




char 


wd_hostname[32]; 




int 


wdJoadav[3]; 




int 


wd boottime; 




struct 


whoent { 

struct outmp we_utmp; 

int wejdie; 




} wd_we[1 024 / sizeof (struct whoent)]; 



}; 

All fields are converted to network byte order prior to transmission. 
The load averages are as calculated by the uptime(C) program, and 
represent load averages over the 5-, 10-, and 15- minute intervals prior 
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to a server's transmission; they are multiplied by 100 for representa- 
tion in an integer. The host name included is that returned by the 
gethostname (SLIB) system call, with any trailing domain name omit- 
ted. The array at the end of the message contains information about 
the users logged in to the sending machine. This information includes 
the contents of the utmp(M) entry for each non-idle terminal line and 
a value indicating the time in seconds since a character was last 
received on the terminal line. 

Messages received by the rwho server are discarded unless they ori- 
ginated at an rwho server's port. In addition, if the host's name, as 
specified in the message, contains any unprintable ASCII characters, 
the message is discarded. Valid messages received by rwhod are 
placed in files named whod.hostname in the directory 
/usr/spool/rwho. These files contain only the most recent message, in 
the format described above. 

Status messages are generated approximately once every 5 minutes. 
rwhod performs an nlist(S) on /unix every 30 minutes to guard against 
the possibility that this file is not the system image currently operat- 
ing. 

See Also ^ 

rwho(TC), ruptime(TC). 

Notes 

There should be a way to relay status information between networks. 
Status information should be sent only upon request, rather than con- 
tinuously. People often interpret the server dying or network commu- 
nication failures as a machine going down. 

Some mechanism for cleaning dead machine data out of the spool 
directory is needed. 
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sendmail 

send mail over the Internet 

Syntax 

/usr/lib/sendmail [ flags ] [ address ... ] 

newaliases 

mailq [ -v ] 

Description 

sendmail sends a message to one or more recipients, routing the mes- 
sage over whatever networks are necessary, sendmail does internet- 
work forwarding as necessary to deliver tiie message to the correct 
place. 

sendmail is not intended as a user interface routine; other programs 
provide user-friendly front ends; sendmail is used only to deliver pre- 
formatted messages. 

With no flags, sendmail reads its standard input up to an end-of-file or 
a line consisting only of a single dot and sends a copy of the message 
found there to £dl of the addresses listed. It determines the network(s) 
to use, based on the syntax and contents of tiie addresses. 

Local addresses are looked up in a file and aliased appropriately. 
Aliasing can be prevented by preceding the address with a backslash. 
Normally, the sender is not included in any alias expansions; for 
instance, if 'John' sends to 'group', and 'group' includes 'John' in the 
expansion, then the letter will not be delivered to 'John'. 

Flags are: 

-ba Go into ARPANET mode. Every input line must end 

with a CR-LF, and each message will be generated 
with a CR-LF at the end. Also, the "From:" and 
"Sender:" fields are examined for the name of the 
sender. 

-bd Run as a daemon, sendmail will fork and run in back- 

ground listening on TCP port 25 for incoming SMTP 
connections. Tliis is normally run from /etc/ re. 

-bi Initialize the alias database. This works only if send- 

mail was built with a DBM library. Otherwise, this 
option does nothing. 
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-bm Deliver mail in the usual way (default). 

-bp Print a listing of the queue. 

-bs Use the SMTP protocol as described in RFC821 on 

standard input and output. This flag implies all the 
operations of the -ba flag that are compatible with 
SMTP. 

-bt Run in address-test mode. This mode reads addresses 

and shows the steps in parsing; it is used for debug- 
ging configuration tables. 

-bv Verify names only; do not try to collect or deliver a 

message. Verify mode is normally used for validating 
users or mailing lists. 

-bz Create the configuration freeze file. 

-Cfile Use alternate configuration file, sendmail refuses to 

run as root if an alternate configuration file is 
specified. The frozen configuration file is bypassed. 

-dX Set debugging value to X. 

-Ffullname Set the full name of the sender. 

-fname Sets the name of the "from" person (that is, the sender 

of the mail), -f can only be used by trusted users (nor- 
mally root, daemon, and network), or if the person 
you are trying to become is the same as the person 
you are. 

-hA^ Set the hop count to A^. The hop count is incremented 

every time the mail is processed. When it reaches a 
limit, the mail is returned with an error message, the 
victim of an aliasing loop. If not specified, 
"Received:" lines in the message are counted. 

-n Don't do aliasing. 

-ox value Set option x to the specified value. Options are 

described below. 
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-q[time] Process saved messages in the queue at given inter- 

vals. If time is omitted, process the queue once, time 
is given as a tagged number, with 's' being seconds, 
'm' being minutes, 'h' being hours, 'd' being days, 
and 'w' being weeks. For example, "-qlhSOm" or 
"-q90m" would both set the timeout to one hour and 
thirty minutes. If time is specified, sendmail will run 
in background. This option can be used safely with 
-bd. 

-rname An alternate and obsolete form of the -f flag. 

-t Read message for recipients. To:, Cc:, and Bcc: lines 

will be scanned for recipient addresses. The Bcc: line 
will be deleted before transmission. Any addresses in 
the argument list will be suppressed, that is, they will 
not receive copies even if listed in the message 
header. 

-V Go into verbose mode. Alias expansions will be 

announced, and so on. 

There is also a number of processing options that may be set. Nor- 
mally these will only be used by a system administrator. Options may 
be set either on the command line using the -o flag or in the configura- 
tion file. These are described in detail in the TCP/IP Administrator's 
Guide. The options are: 

Afile Use alternate alias file. 

c On mailers that are considered expensive to connect 

to, do not initiate immediate coimection. This 
requires queueing. 

dx Set the delivery mode to x. Delivery modes are *i' for 

interactive (synchronous) delivery, 'b' for background 
(asynchronous) delivery, and 'q' for queue only - that 
is, actual delivery is done the next time the queue is 
run. 

D Try to rebuild the alias database automatically if 

necessary. 
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ex 



Fmode 
f 

gN 

i 
m 



Qqueuedir 
Ttimeout 

Sfile 

s 

Ttime 



Set error processing to mode x. Valid modes are 'm' to 
mail back the error message, 'w' to "write" back the 
error message (or mail it back if the sender is not 
logged in), 'p' to print the errors on the terminal 
(default), 'q' to throw away error messages (so that 
only exit status is returned), and 'e' to do special pro- 
cessing for the BerkNet. If the text of the message is 
not mailed back by mode 'm' or 'w' and if the sender 
is local to this machine, a copy of the message is 
appended to the file dead.letter in the sender's home 
directory. 

The mode to use when creating temporary files. 

Save UNIX-style From lines at the front of messages. 

The default group id to use when calling mailers. 

The SMTP help file. 

Do not take dots on a line by themselves as a message 
terminator. 



Send to "me' 
expansion. 



(the sender) also if I am in an alias 



If set, this message may have old-style headers. If not 
set, this message is guaranteed to have new style 
headers (that is, commas instead of spaces between 
addresses). If set, an adaptive algorithm is used that 
will correctly determine the header format in most 
cases. 

Select the directory in which to queue messages. 

The timeout on reads; if none is set, sendmail will 
wait forever for a mailer. This option violates the 
word (if not the intent) of the SMTP specification, so 
the timeout should probably be fairly large. 

Save statistics in the named file. 

Always instantiate the queue file, even under cir- 
cumstances where it is not strictly necessary. This 
provides safety against system crashes during 
delivery. 

Set the timeout on undelivered messages in the queue 
to the specified time. After delivery has failed (for 
instance, because a host is down) for this amount of 
time, failed messages will be returned to the sender. 
The default is three days. 
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Xstz,dtz Set the name of the time zone. 

vxN Set the default user id for mailers. 

In aliases, the first character of a name may be a vertical bar to cause 
interpretation of the rest of the name as a command to which to pipe 
the mail. It may be necessary to quote the name to keep sendmail 
from suppressing the blanks between arguments. For example, a com- 
mon alias is: 

msgs: "l/usr/ucb/msgs -s" 

Aliases may also have the syntax ":include:^/e«ame " to ask sendmail 
to read the named file for a list of recipients. For example, an alias 
such as: 

poets: ":inchide:/usr/local/lib/poets.list" 

would read /usr/local/lib/poets.Ust for the list of addresses making up 
the group. 

The sendmail commaaid returns an exit status describing what it did. 
The codes are defined in <sysexits.h >: 

EX_OK Successful completion on all addresses. 

EX_NOUSER User name not recognized. 

EX_UNAVAILABLE Catchall, meaning necessary resources 

were not available. 
EX_SYNTAX Syntax error in address. 

EX_SOFTWARE Internal software error, including bad 

arguments. 
EX_OSERR Temporary operating-system error, such 

as cannot fork. 
EX_NOHOST Host name not recognized. 

EX_TEMPFAIL Message could not be sent immediately, 

but was queued. 

If invoked as newaliases, sendmail will rebuild the alias database. 
Tliis works only if sendmail was built with a DBM library. Otherwise, 
this option does nothing. If invoked as mailq, sendmail will print the 
contents of the mail queue. 

Fifes 

Except for /usr/Iib/sendmail.cf, these pathnames are all specified in 
/usr/lib/sendmail.cf. Thus, these values are only approximations. 

Aisr/lib/aliases raw data for alias names 

/usr/lib/sendmail.cf configuration file 

/usr/lib/sendmail.fc frozen configuration 

/usr/lib/sendmail.hf help file 
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/usr/lib/sendmail.st 
/usr/spool/mqueue/* 



collected statistics 
temp files 



See Also 



mail(TC), aliases(SFF), mailaddr(SFF); 

RFC819, RFC821, RFC822; 

The chapter "Introduction to sendmail" in the TCP/IP Administrator's 

Guide; 

The chapter "Installing and Operating Sendmail" in the TCP/IP 

Administrator's Guide. 
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slattach, sidetach 

attach and detach serial lines as network interfaces 
Syntax 

/etc/slattach devname source destination [ baudrate ] 
/etc/sldetach interface-name 

Description 

slattach is used to assign a serial (tty) line to a network interface using 
the DARPA Internet Protocol, and to define the source and destination 
network addresses. The devname parameter is the name of the device 
the serial line is attached to, that is, /dev/ttyOOl. The source and desti- 
nation are either host names present in the host name data base (see 
hosts(SFF)), or DARPA Internet addresses expressed in the Internet 
standard "dot notation." The optional baudrate parameter is used to 
set the speed of the connection; if not specified, the default of 9600 is 
used. 

Only the superuser may attach or detach a network interface. 

There should not be a getty (M) on the line. 

sidetach is used to remove the serial line that is being used for IP from 
the network tables and allow it to be used as a normal terminal again. 
interface-name is the name that is shown by netstat(YC). 

Examples 



/etc/slattach ttyOOl tom-src genstar 
/etc/slattach /dev/tty001 hugo dahl 4800 
/etc/sldetach sl01 



Files 



/etc/hosts 

/dev/* 

/usr/spool/locks/slippid.* 
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Diagnostics 

Various messages indicating: 

- the specified interface does not exist 

- the requested address is unknown 

- the user is not the superuser 

See Also 

hosts(SFF), netstat(TC), ifconfig(ADMN). 
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slink 

streams linker 

Syntax 

slink [-v] [-f] [ -c file] [func [argl arg2 ...]] 

Description 

slink is a STREAMS configuration utility that is used to link together 
the various STREAMS modules and drivers required for STREAMS 
TCP/DP. Input to slink is in the form of a script specifying the 
STREAMS operations to be performed. Input is normally taken from 
the file /etc/strcf . 

The following options may be specified on the slink command line: 

-cfile Use. file instead of /etc/strcf . 

-V Verbose mode (that is, each operation is logged to stderr). 

-f Do not fork (that is, slink will remain in foreground). 

The configuration file contains a list of functions, each of which is 
composed of a list of commands. Each command is a call to one of 
the functions defined in the configuration file or to one of a set of 
built-in functions. Among the built-in functions are the basic 
STREAMS operations open, link, and push, along with several 
TCP/IP-specific functions. 

slink processing consists of parsing the input file, then calling the 
user-defined function boot, which is normally used to set up the stan- 
dard configuration at boot time. If a function is specified on the slink 
command line, that function will be called instead of boot. Following 
the execution of the specified function, slink goes into the background 
and remains idle, holding open whatever file descriptors have been 
opened by the configuration commands. 

A function definition has the following form: 

function-name { 

commandl 
command2 

} 
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The syntax for commands is: 

function arg1 arg2 arg3 ... 
or: 

var = function arg1 arg2 arg3 ... 

The placement of newlines is important: a newline must follow the 
left and right braces and every command. Extra newlines are allowed, 
that is, where one newline is required, more than one may be used. A 
backslash (V) followed immediately by a newline is considered 
equivalent to a space, so it may be .used to continue a command on a 
new line. The use of other white space characters (spaces and tabs) is 
at the discretion of the user, except that there must be white space 
separating the function name and the arguments of a command. 

Comments are delimited by '#' and newline, and are considered 
equivalent to a newline. 

Function and variable names may be any string of characters taken 
from A-Z, a-z, 0-9, and '_', except that the first character cannot be a 
digit. Function names and variable names occupy separate name 
spaces. All functions are global and may be forward-referenced. All 
variables are local to the functions in which they occur. 

Variables are defined when they appear to the left of an equal sign 
('=') on a command line, such as: 

top = open /dev/inet/tcp 

The variable acquires the value returned by the command. In the 
above example, the value of the variable tcp will be the file descriptor 
returned by the open call. 

Arguments to a command may be variables, parameters, or strings. 

A variable that appears as an argument must have been assigned a 
value on a previous command line in that function. 

Parameters take the form of a dollar sign ('$') followed by one or two 
decimal digits, and are replaced with the corresponding argument 
from the function call. If a given parameter was not specified in the 
function call, an error results (for instance, if a command references 
$3 and only two arguments were passed to the function, an execution 
error will occur). 

Strings are sequences of characters optionally enclosed in double 
quotes ("")• Quotes may be used to prevent a string from being inter- 
preted as a variable name or a parameter, and to allow the inclusion of 
spaces, tabs, and the special characters '{', '}', '=', and '#'. The 
backslash (Y) may also be used to quote the characters '{', '}', '=', 
'#', "", and "X' individually. 
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The following built-in functions are provided by slink : 



open path 



link fdlfd2 



push fd module 



sifname/J link name 



nmistl fd unit 



dlattach/<i unit 



Open the device specified by pathname 
path. Returns a file descriptor referencing 
the open stream. 

Link the stream referenced by fd2 beneath 
the stream referenced by fdl . Returns the 
link identifier associated with the link. 
Note: The fd2 function cannot be used 
after this pperation. 

Push the module identified by module onto 
the stream referenced by/<i. 

Send a SIOCSIFNAME (set interface 
name) ioctl down the stream referenced by 
fd for the link associated with link 
identifier link specifying the name given in 
name. 

Send a IF_UNITSEL (unit select) ioctl 
down the stream referenced by fd specify- 
ing the unit given in unit. 

Send a DL_ATTACH_REQ message down 
the stream referenced by fd specifying the 
imit given in unit. 



initqp path qname lowat hiwat ... 

Send an INTTQPARMS (initialize queue 
parameters) ioctl to the driver correspond- 
ing to pathname path, qname specifies the 
queue for which the low and high water 
marks will be set, and must be one of: 



hd 

rq 

wq 

muxrq 

muxwq 



stream head 
read queue 
write queue 
multiplexor read queue 
multiplexor write queue 



strcat strl str2 



The lowat mid hiwat functions specify the 
new low and high water marks for the 
queue. Both lowat and hiwat must be 
present. To change only one of these 
parameters, the other may be replaced with 
a dash ('-'). Up to five qname lowat hiwat 
triplets may be present. 

Concatenate strings strl and str2 and 
return the resulting string. 
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return val 

Files 



SLINK (ADMN) 

Set the return value for the current function 
to val. Note: executing a return command 
does not terminate execution of the current 
function. 



/etc/strcf 

See Also 



strcf(SFF), intro(ADMP). 
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talkd 

remote user communication server 
Syntax 

/etc/talkd 

Description 

Talkd is the server that notifies a user that somebody else wants to ini- 
tiate a conversation. It acts as a repository of invitations, responding 
to requests by clients wishing to rendezvous to hold a conversation. In 
normal operation, a talk client initiates a rendezvous by sending a 
CTL_MSG to the server of type LOOK_UP (see <protocolsltalkd.h >). 
This causes the server to search its invitation tables to check if an 
invitation currently exists for the client. If the lookup fails, the caller 
then sends an ANNOUNCE message causing the server to broadcast 
an announcement on the callee's login ports requesting contact. When 
the callee responds, the local server uses the recorded invitation to 
respond with the appropriate rendezvous address and the caller and 
callee client programs establish a stream connection through which 
the conversation takes place. 

See Also 

talk(TC), write(TC) 
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/etc/tcp 



TCP start/stop script 
Syntax 



/etc/tcp start 
/etc/tcp stop 

Description 



letcltcp is used to start or stop the STREAMS TCP software. TCP will 
start automatically at system startup time if /etc/Tc.d/6lname contains 
a script including the command /etc/tcp start. TCP does not stop au- 
tomatically at system shutdown time. The command /etc/tcp stop 
will stop TCP. See init(M) for further information. 

/etc/tcp must be customized for a particular installation before it can 
be used. The following items must be edited: 



Domain name 



Interface configuration 



The environment variable DOMAIN must 
be set to the name of your domain. 

ifconfig commands must be used to set the 
internet address (and any other desired 
options) for each of your interfaces. The 
ifconfig line for the loopback interface 
should not require modification. See 
i/con/zgCADMN) for further information. 



The following items may need to be edited: 



PATH 



PROCS 



The supplied path may require 
modification if commands run by letcltcp 
are in other directories. 

The PROCS variable contains a space- 
separated list of names of processes to kill 
when executing the stop function. If 
additional daemons are used, their names 
can be added to this list. 



Network initialization 



Certain network hardware may require the 
execution of an initialization command 
before use. Any such conmiands should 
be included in this section. 
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Daemons The standard internetworking daemons 

are started at this point. Any additional 
daemons or other commands may be 
included in this section. Any of the stan- 
dard daemons that are not desired may be 
removed or commented out. 
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telnetd 

DARPA TELNET protocol server 
Syntax 

/etc/telnetd 

Description 

telnetd is a server that supports the DARPA standard TELNET virtual 
terminal protocol, telnetd is invoked by the internet server (see 
inetd{ADMN)), normally for requests to connect to the TELNET port 
as indicated by the /etc/services file (see services (SFF)). 

telnetd operates by allocating a pseudo-terminal device for a client, 
then creating a login process that has the slave side of the pseudo ter- 
minal as stdin, stdout, and stderr. telnetd manipulates the master 
side of the pseudo-terminal, implementing the TELNET protocol and 
passing characters between the remote client and the login process. 

When a TELNET session is started up, telnetd sends TELNET 
options to the client side indicating a willingness to do remote echo of 
characters, to suppress go ahead, and to receive terminal type informa- 
tion from the remote client. If the remote client is willing, the remote 
terminal type is propagated in the environment of the created login 
process. The pseudo-terminal allocated to the client is configured to 
operate in ICANON mode, and with TABS and ICRNL enabled. (See 
termio(M).) 

telnetd is willing to do: echo, binary, suppress go ahead, and timing 
mark, telnetd is willing to have the remote client do: binary, termi- 
nal type , and suppress go ahead. 

See Also 

tehietCrC) 

Notes 

Some TELNET commands are only partially implemented. 

The TELNET protocol allows for the exchange of the number of lines 
and colunms on the user's terminal, but telnetd does not make use of 
them. 
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Because of bugs in the original 4.2 BSD telnet, telnetd performs some 
dubious protocol exchanges to try to discover if the remote client is, in 
fact, a 4.2 BSD telnet. 

Binary mode has no common interpretation except between similar 
operating systems (Unix, in this case). 

The terminal type name received from the remote client is converted 
to lowercase. 

The packet interface to the pseudo terminal should be implemented 
for intelligent flushing of input and output queues. 

telnetd never sends TELNET go ahead commands. 
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tftpd 



DARPA Trivial File Transfer Protocol server 
Syntax 



/etc/tftpd 

Description 



tftpd is a server that supports the DARPA Trivial File Transfer Proto- 
col. The TFTP server operates at the port indicated in the tftp service 
description; see services (SFF). This port number may be overridden 
(for debugging purposes) by specifying a port number on the com- 
mand line. 

The use of tftp does not require an account or password on the remote 
system. Due to the lack of authentication information, tftpd will allow 
only publicly readable files to be accessed. Note that tihis extends the 
concept of public to include all users on all hosts that can be reached 
through the network; this may not be appropriate on all systems, and 
its implications should be considered before enabling tftp service. 

tftpd is spawned by the superserver inetd and, therefore, must have an 
entry in inetd 's configuration file, /etc/inetd.conf. [See 
inetd (ADW<i) and inetd.cortf{SFF).] Note that the tftpd entry in this 
file must be "wait": this is to prevent subsequent selects from being 
successful before the first tftpd process does its receive . tftpd takes 
care to prevent multiple tftpd processes from being spawned to service 
the same request, {inetd is able to continue processing new messages 
on the port.) 



See Also 



inetd(ADMN), tftp(TC), inetd.conf(SFF), services(SFF). 

Warning s 

This ser ver is known only to be self-consistent (that is, it operates with 
the user TFTP program tftp (TC)). 

The search permissions of the directories leading to the files accessed 
are not checked if tftp runs as root. The default configuration runs 
tftpd as user "sync." 
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timed 

time server daemon 
Syntax 

/etc/timed [ -t ] [ -M ] [ -n network ] [ -i network ] 

Description - 

timed is the time server daemon and is normally invoked at boot time 
from the STREAMS TCP/IP start-up script. It synchronizes the host's 
time with that of other machines in a local area network running 
timed(ADMN). These time servers will slow down the clocks of some 
machines and speed up the clocks of others to bring them to the aver- 
age network time. The average network time is computed from meas- 
urements of clock differences using the ICMP timestamp request mes- 
sage. 

The service provided by timed is based on a master-slave scheme. 
When timed (ADMN) is started on a machine, it asks the master for the 
network time and sets the host's clock to that time. After that, it 
accepts synchronization messages periodically sent by the master and 
calls adjtime (SSC) to perform the needed corrections on the host's 
clock. 

It also communicates with rdate(ADMN) in order to set the date glo- 
bally, and with timedc (ADMN), a timed control program. If the ma- 
chine running the master crashes, then the slaves will elect a new mas- 
ter from among slaves running with the -M flag. A timed running 
without the -M flag will remain a slave. The -t flag enables timed to 
trace the messages it receives in the file /usr/adm/timed.log. Tracing 
can be tumed on or off by the program timedc(ADMN). timed nor- 
mally checks for a master time server on each network to which it is 
connected, except as modified by the options described below. It will 
request synchronization service from the first master server located. If 
permitted by the -M flag, it will provide synchronization service on 
any attached networks on which no current master server was 
detected. Such a server propagates the time computed by the top-level 
master. The -n flag, followed by the name of a network to which the 
host is connected (see networks(SFF)), overrides the default choice of 
the network addresses made by the program. Each time the -n flag 
appears, that network name is added to a list of valid networks. All 
other networks are ignored. The -i flag, followed by the name of a 
network to which the host is connected (see networks(SFF)), OY&mdes 
the default choice of the network addresses made by the progr^n. 
Each time the -i flag appears, that network name is added to a list of 
networks to ignore. All other networks are used by die time daemon. 
TTie -n and -i flags are meaningless if used together, 
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Files 

/usr/adm/timed.log tracing file for timed 

/usr/adm/timed.masterlog log file for master timed 

See Also 

date(C), adjtime(SSC), gettimeofday(SLIB), icmp(ADMP), 
rdate(ADMN), timedc(ADMN). 
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timedc 

timed control program 

Syntax 

timedc [ command [ argument ... ] ] 

Description 

timedc is used to control the operation of the timed program. It may 
be used to: 

• measure the differences between machines' clocks, 

• find the location where the master time server is running, 

• enable or disable tracing of messages received by timed, and 

• perform various debugging actions. 

Without any arguments, timedc will prompt for commands from the 
standard input. If arguments are supplied, timedc interprets the first 
argument as a command and the remaining arguments as parameters 
to the command. The standard input may be redirected, causing 
timedc to read conmiands from a file. Commands may be abbreviated; 
recognized commands are: 

? [ command ... ] 

help [ command ... ] 

Print a short description of each command specified in the argu- 
ment list or, if no arguments are given, a list of the recognized 
commands. 

clockdiff host ... 

Compute the differences between the clock of the host machine 
and the clocks of the machines given as arguments. 

trace [onloff] 

Enable or disable the tracing of incoming messages to timed in the 
file /usr/adm/timed.log. 

quit 

Exit from timedc. 

Other commands may be included for use in testing and debugging 
timed; the help command and the program source may be consulted 
for details. 
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Files 

Aisr/adm/timed.log tracing file for timed 

Aisr/adm/timed.masterlog log file for master timed 

See Also 

date(C), adjtime(SSCj, icmp(ADMP), rdate(ADMN), timed(ADMN). 

Diagnostics 

?Ambiguous command abbreviation matches more than one command 

?Invalid command no match found 

?Privileged command command can be executed by root only 
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trace, query 

routing tools 

Syntax 

trace [onloff] machines... query [-n] hosts... 

Description 

trace sends a RIP_TRACE_ON or RIP_TRACE_OFF command to the 
specified machines. Machine must be specified as an IP address. 

query is used to request routing information from the specified host. 
Any packets received in response to a query will be displayed. 

These commands are useful for debugging routed(ADMN). 

See Also 

routed(ADMN), udp(ADMP). 
RFC1058 

Bugs 

RFC 1058 states that TRACE_ON and TRACE_OFF are not supposed 
to be supported any more. 
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trpt 



transliterate protocol trace 
Syntax 



trpt [ -a ] [ -s ] [ -t ] [ -f ] [ -j ] [ -p hex-address ] [ system [ core ] ] 

Description 

trpt interrogates the buffer of TCP trace records created when a socket 
is marked for debugging (see getsockopt (SSC)), and prints a readable 
description of these records. When no options are supplied, trpt prints 
all the trace records found in the system, grouped according to TCP 
connection protocol control block (PCB). The following options may 
be used to alter this behavior. 

-a In addition to the normal output, print the values of the source and 
destination addresses for each packet recorded. 

-s In addition to the normal output, print a detailed description of the 
packet sequencing information. 

-t In addition to the normal output, print the values for all timers at 
each point in the trace. 

-f Follow the trace as it occurs, waiting a short time for additional 
records each time the end of the log is reached. 

-j Just give a hst of the protocol control block addresses for which 
there are trace records. 

-p Show only trace records associated with the protocol control block, 
the address of which follows. 

The recommended use of trpt is as follows. Isolate the problem and 
enable debugging on the socket(s) involved in the connection. Find 
the address of the protocol control blocks associated with the sockets 
using the -A option to netstat (TC). Then run trpt with the -p option, 
supplying the associated protocol control block addresses. The -f 
option can be used to follow the trace log, once the trace is located. If 
there are many sockets using the debugging option, the -j option may 
be useful in checking to see if any trace records are present for the 
socket in question. 

If debugging is being performed on a system or core file other than the 
default, the last two arguments may be used to supplant the defaults. 
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Files 

/unix 
/dev/kmem 

See Also 

getsockopt(SSC), netstat(TC) 

Diagnostics 

The message "no namelist" when the system image doesn't contain 
the proper symbols to find the trace bufifer; other messages which 
should be self explanatory. 



Bugs 



Should also print the data for each input or output, but this is not saved 
in the trace record. 

The output format is inscrutable and should be described here. 
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Intro 

introduction to special files and protocols 

#include <sys/socket.h> 
#include <netinet/in.h> 
#include <netinet/lp_str.h> 
#include <netinet/strioc.h> 

Description 

This section describes various special files and protocols that refer to 
specific System V STREAMS TCP/IP networking protocol drivers. 
Features common to a set of protocols are documented as a protocol 
family. 

Protocol Family Entries 

A protocol family provides basic services to the protocol implementa- 
tion to allow it to function within a specific network environment. 
These services may include packet fragmentation and reassembly, 
routmg, addressing, and basic transport. A protocol family may sup- 
port multiple methods of addressing, though the current protocol 
implementations do not. A protocol family is normally comprised of a 
number of protocols, one per socket {2) type. It is not required that a 
protocol family support all socket types. A protocol family may con- 
tain multiple protocols supporting the same socket abstraction. 

A protocol supports one of the socket abstractions detailed in 
socket(2). A specific protocol may be accessed by creating a socket 
of the appropriate type and protocol family, by requesting the protocol 
explicitly when creating a socket, by executing the appropriate TLI 
primitives, or by opening the associated STREAMS device. 

Protocol Entries 

The system currently supports the DARPA Internet protocols. Raw 
socket interfaces are provided to the IP protocol layer of the DARPA 
Internet and to the ICMP protocol. Consult the appropriate manual 
pages in this section for more information. 



Routing loctis 



The network facilities provided limited packet routing. A simple set 
of data structures comprise a "routing table" used in selecting the ap- 
propriate network interface when transmitting packets. This table 
contains a single entry for each route to a specific network or host. A 
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user process, the routing daemon, maintains this data base with the aid 
of two socket-specific ioctl{2) commands, SIOCADDRT and SIOC- 
DELRT. The commands allow the addition and deletion of a single 
routing table entry, respectively. Routing table manipulations may 
only be carried out by super-user. 

A routing table entry has the following form, as defined in 
<netl route. h>: 

struct rtentry { 



u_long 


rt_hash; 


struct 


sockaddr rt dst; 


struct 


sockaddr rt gateway 


short 


rt_flags; 


short 


rt_refcnt; 


u_long 


rt use; 


struct 


if net *rt_ifp; 



}; 
with rtjlags defined as follows: 

fdefine RTFJUP 0x1 /* route usable */ 

#define RTF_GOTEWAY 0x2 /* destination is a gateway */ 
#define RTF_HOST 0x4 /* host entry (net otherwise) */ 
#define RTFJDYNAMIC 0x10 /* created dynamically 

(by redirect) */ 

Routing table entries are of three general types: those for a specific 
host, those for all hosts on a specific network, and those for any desti- 
nation not matched by entries of the first two types (a wildcard route). 
When the system is booted and addresses are assigned to the network 
interfaces, each protocol family installs a routing table entry for each 
interface when it is ready for traffic. Normally the protocol specifies 
the route through each interface as a "direct" connection to the desti- 
nation host or network. If the route is direct, the transport layer of a 
protocol family usually requests the packet be sent to the same host 
specified in the packet. Otherwise, the interface is requested to 
address the packet to the gateway listed in the routing entry (that is, 
the packet is forwarded). 

Routing table entries installed by a user process may not specify the 
hash, reference count, use, or interface fields; these are filled in by the 
routing routines. If a route is in use when it is deleted (rt_refcnt is 
non-zero), the routing entry will be marked down and removed from 
the routing table, but the resources associated with it will not be 
reclaimed until all references to it are released. The routing code 
returns EEXIST if requested to duplicate an existing entry, ESRCH if 
requested to delete a non-existent entry, or ENOSR if insufficient 
resources were available to install a new route. User processes read 
the routing tables through the Idevlkmem device. The rtjise field con- 
tains the number of packets sent along the route. 
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When routing a packet, the kernel will first attempt to find a route to 
the destination host. Failing that, a search is made for a route to the 
network of the destination. Finally, any route to a default ("wild- 
card") gateway is chosen. If multiple routes are present in the table, 
the first route found will be used. If no entry is found, the destination 
is declared to be unreachable. 

A wildcard routing entry is specified with a zero destination address 
value. Wildcard routes are used only when the system fails to fmd a 
route to the destination host and network. The combination of wild- 
card routes and routing redirects can provide an economical mecha- 
nism for routing traffic. 

Socket loctis 

There are a few ioctls which have significance for the socket layer 
only. The ioctl call has the general form: 

ioctl(so, code, arg) 

SIOCPROTO 

Enter a socket type into the kernel protocol switch table. The 
arguments used to create the socket used by this ioctl may be zero. 
The new socket type is downloaded by setting arg to a pointer to a 
specification block with the following structure: 

struct socknewproto { 

int family; /* address family (AF_INET, etc.) */ 
int type; /* protocol type 

(SOCK_STREAM, etc.) */ 
int proto; /* per family proto number */ 
dev_t dev; /* major/minor to use 

(must be a clone) */ 
int flags; /* protosw flags */ 
}; 

The flags currently supported are specified in the <netl protosw. h> 
header file as: 

/* exchange atomic messages only */ 
#define PRJflXMIC 0x01 

/* addresses given with messages */ 
#define PRJVDDR 0x02 

/* connection required by protocol */ 
#define PR_CONNREQUIRED 0x04 

#define PR_RIGHTS 0x10 /* passes capabilities */ 
fdefine PRJBINDPROTO 0x20 /* pass protocol */ 

SIOCXPROTO 

Purge the protocol switch table. The arguments used to create the 
socket used by this ioctl may be zero. 
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SIOCSPGRP 

Set the process group for a socket to enable signaling (SIGUSRl) 
of that process group when out-of-band data arrives. The argu- 
ment, arg, is a pointer to an int and, if positive, is treated as a pro- 
cess ID; otherwise, (if negative) is treated as a process group ID. 

SIOCGPGRP 

Get the process group ID associated with a particular socket. If the 
value returned to the int location pointed to by arg is negative, it 
should be interpreted as a process group ID; otherwise, it should be 
interpreted as a process ID. 

SIOCCATMARK 

Used to , ascertain whether or not the socket read pointer is 
currently at the point (mark) in the data stream where out-of-band 
data was sent. If a 1 is returned to the int location pointed to by 
arg, the next read will return data after the mark. Otherwise 
(assuming out-of-band data has arrived), the next read will provide 
data sent by the client prior to transmission of the out-of-band sig- 
nal. 

FIONREAD 

Returns (to the int location pointed to by arg ) the number of bytes 
currently waiting to be read on the socket. 

FIONBIO 

Toggles the socket into blocking/non-blocking mode. If the int 
location pointed to by arg contains a non-zero value, subsequent 
socket operations that would cause the process to block waiting on 
a specific event will return abnormally with errno set to 
EWOULDBLOCK; otherwise, the process will block. 

Queue loctis 

Each STREAMS device has default queue high and low water marks, 
that can be changed by the super-user with the INITQPARMS specifi- 
cation in an ioctI(2). The ioctl is done on a driver or module, with the 
argument being an array of structures of type: 

struct iocqp { 

ushort iqp_type; 

ushort iqp_value; 
} 

iqp_value specifies the value for the queue parameter according to 
iqp_type, which may be one of: IQP_RQ(read queue), 
IQP_WQ(write queue), IQP_MUXRQ(mux read queue), 
IQP_MUXWQ(mux write queue), or IQP_HDRQ(stream head 
queue), each OR'ed with either IQP_LOWAT( value is for low water 
mark of queue), or IQP_HIWAT(value is for high water mark of 
queue). 
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Interface loctis 

Each network interface in a system corresponds to a path through 
which messages may be sent and received. A network interface usu- 
ally has a hardware device associated with it, although certain inter- 
faces such as the loopback interface, /o(7), do not. 

The following ioctl calls may be used to manipulate network inter- 
faces. The ioctl is made on a socket (typically of type SOCK_DGRAM 
) in the desired "communications domain" [see protocolsiA)]. Unless 
specified otherwise, the request takes an if request structure as its 
parameter. This structure has the form 

struct ifreq { 

char ifr_name ;i6] ; /* name of interface (e.g. ecO) */ 
■union { 

struct sockaddr ifru_addr; 

struct SDckaddr ifru_dstaddr; 

struct sockaddr ifru_broadaddr; 

short i f ru_f lags ; 

int ifru_iretric; 

struct cr.epacket ifru_onepacket; 
} ifr_ifru; 
#define ifr_addr ifr_ifru.ifru_addr /* address */ 

/* other end of p-to-p link */ 
fdefine ifr_dstaddr ifr_ifru.ifru_dstaddr 

/* broadcast address */ 
tdefine ifr_broadaddr ifr_ifru.ifru_broadaddr 
♦define ifr_flags ifr_ifru.ifru_flags /* flags */ 

/* routing metric */ 
fdefine ifrjtnetric ifr_ifru.ifru_nietric 

/* one-packet niode params */ 
♦define ifr_onepacket ifr_ifru.ifru_onepacket 
}; 

SIOCSIFADDR 

Set interface address for protocol family. Following the address 
assignment, the "initialization" routine for the interface is called. 

SIOCGIFADDR 

Get interface address for protocol family. 

SIOCSIFDSTADDR 

Set point to point address for protocol family and interface. 

SIOCGIFDSTADDR 

Get point to point address for protocol family and interface. 

SIOCSIFBRDADDR 

Set broadcast address for protocol family and interface. 
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SIOCGIFBRDADDR 

Get broadcast address for protocol family and interface. 

SIOCSIFFLAGS 

Set interface flags field. If the interface is marked down, any pro- 
cesses currently routing packets through the interface are notified; 
some interfaces may be reset so that incoming packets are no 
longer received. When marked up again, the interface is reinitial- 
ized. 

SIOCGIFFLAGS 

Get interface flags. 

SIOCSIFMETRIC 

Set interface routing metric. The metric is used only by user-level 
routers. 

SIOCGIFMETRIC 

Get interface metric. 

SIOCSIFONEP 

Set one-packet mode parameters. The ifr_onepacket field of the 
ifreq structure is used for this request. Tliis structure is defined as 
follows: 

struct onepacket { 

int spsize; /* small packet size */ 

int spthresh; /* small packet threshold */ 

}; 

One-packet mode is enabled by setting the IFF_ONEPACKET flag 
(see SIOCSIFFLAGS above). See tcp(l) for an explanation of one- 
packet mode. 

SIOCGIFONEP 

Get one-packet mode parameters. 

SIOCGIFCONF 

Get interface configuration list. This request takes an ifconf struc- 
ture (see below) as a value-result parameter. The ifcjen field 
should be initially set to the size of the buffer pointed to by ifcjbuf. 
On retam it will contain the length, in bytes, of the configuration 
list. 

/* structure used in SIOCGIFCONF request. 

* Used to retrieve interface configuration 

* for machine (useful for programs which 

* must know all networks accessible) . 
*/ 

struct ifconf { 

/* size of associated buffer */ 
int ifc len; 
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union { 

caddr_t ifcu_buf; 
struct ifreq *ifcu_req; 
} ifc_ifcu; 
/* buffer address */ 
#define ifc_buf if c_if cu. if cu_buf 
/* array of structures returned */ 
tdefine ifc_req if c_if cu. if cu_req 

}; 

Streams locti Interface 

Socket ioctl calls can also be issued using STREAMS file descriptors. 
The standard strioctl structure is used, with the ic_cmd field contain- 
ing the socket ioctl code (from <sys/socket.h>) and the ic_db field 
pointing to the data structure appropriate for that ioctl , for all socket 
ioctl s except SIOCGIFCONF. For the SIOCGIFCONF ioctl, an ifconf 
structure is not used. Rather, the ic_db field points to the buffer to 
receive the ifreq structures. 



TLI Options Management 



Options may be set and retrieved in a manner similar to getsockopt (2) 
and setsockopt (2) using t_optmgmt (3N). Options are communicated 
using an options buffer, which contains a list of options. Each option 
consists of an option header and an option value. The opthdr structure 
gives the format of the option header: 

struct opthdr { 

long level; /* protocol level affected */ 

long name; /* option to modify */ 

long len; /* length of option value (in bytes) */ 
}; 

The option value must be a multiple of sizeof(long) bytes in length, 
and must immediately follow the option header. Following the option 
value is the header of the next option, if present. 

To get the values of options, set the flags field of the t_optmgmt struc- 
ture to T_CHECK. It is not necessary to set the len fields in the option 
headers to the expected lengths of the option values, nor is it neces- 
sary to provide space between option headers for the option values to 
be stored (the len fields should be set to zero and the option headers 
should be adjacent). A new options buffer will be formatted and 
returned to the user. Note that T_CHECK may have failed even if 
t_optmgmt returns zero. The user must check the flags field of the 
returned t_optmgmt structure. If this field contains T_FAILURE, one 
or more of the options were invalid. 
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To set options, set the flags field of the t_optmgmt structure to 
T_NEGOTIATE. 

To retrieve the default values of all options, set the flags field of the 
t_optmgmt structure to T_DEFAIJLT. For this operation, no input 
buffer should be specified. 

Note 

System V STREAMS TCP/IP man pages frequently cite appropriate 
RFCs (Requests for Comments). RFCs can be obtained from the DDN 
Network Information Center, SRI International, Menlo Park, CA 
94025. 

See Also 

ioctl(SSC), socket(SSC), t_optmgmt(NSL), tcp(ADMP). 
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arp 



Address Resolution Protocol 
Description 



ARP is a protocol used to map dynamically between DARPA Internet 
and lOMb/s Ethemet addresses. It is used by all the lOMb/s Ethernet 
interface drivers rurming the Internet protocols. 

ARP caches Internet-Ethernet address mappings. When an interface 
requests a mapping for an address not in the cache, ARP queues the 
message which requires the mapping and broadcasts a message on the 
associated network requesting the address mapping. If a response is 
provided, the new mapping is cached and any pending message is 
transmitted. ARP will queue at most one packet while waiting for a 
mapping request to be answered; only the most recently "transmitted" 
packet is kept. The ARP protocol is implemented by a STREAMS 
driver to do the protocol negotiation, and by a separate STREAMS 
module to do the address translation. 

To facilitate communications with systems that do not use ARP, ioctl s 
are provided to enter and delete entries in the Intemet-to-Ethemet 
tables. Usage: 

#include <sys/ioctl.h> 
#include <sys/socket.h> 
#include <net/if.h> 
struct arpreq arpreq; 

ioctl(s, SIOCSARP, (caddr_t)&arpreq); 
ioctl(s, SIOCGARP, (caddr_t)&arpreq); 
ioctl(s, SIOCDARP, (caddr_t)&arpreq); 

Each ioctl takes the same structure as an argument. SIOCS.ARP sets an 
ARP entry, SIOCGARP gets an ARP entry, and SIOCDARP deletes an 
ARP entry. These ioctls may be applied to any socket descriptor s, but 
only by the superuser. The arpreq structure is as follows: 

/* ARP ioctl request */ 
struct arpreq { 

struct sockaddr arp_pa;/* protocol address V 
struct sockaddr arp_ha;/* hardware address */ 
int arpjlagsy* flags */ 

}; 

/* arp_flags field values */ 
#defineATF_C0M 0x02/* completed entry 

{arp_ha valid) */ 
#defineATF_PERM 0x04/* permanent entry */ 
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#defineATF_PUBL 0x08/* publish 

(respond for other host) */ 
#defineATF_USETRAILERS0x10/* send trailer packets 

to host */ 

The address family for the arp_pa sockaddr , must be AF_INET; for 
the arpjia sockaddr it must be AF_IJNSPEC. The only flag bits which 
may be written are ATF_PERM, ATF_PUBL and ATF_USETRAILERS. 
ATF_PERM causes the entry to be permanent if the ioctl call succeeds. 
The peculiar nature of the ARP tables may cause the ioctl to fail if 
more than 8 (permanent) Internet host addresses hash to the same slot. 
ATF_PUBL specifies that the ARP code should respond to ARP 
requests for the indicated host coming from other machines. This 
allows a host to act as an "ARP server," which may be useful in con- 
vincing an ARP-only machine to talk to a non-ARP machine. 

ARP can also negotiate the use of trailer IP encapsulations; trailers are 
an alternate encapsulation used to allow efficient packet alignment for 
large packets despite variable-sized headers. Hosts that wish to 
receive trailer encapsulations indicate so by sending gratuitous ARP 
translation replies along with replies to IP requests; Siey are also sent 
in reply to IP translation replies. The negotiation is thus fully sym- 
metrical, in that either or both hosts may request trailers. The 
ATF_USETRAILERS flag is used to record the receipt of such a reply, 
and enables the transmission of trailer packets to that host. 

ARP watches passively for hosts impersonating the local host (that is, 
a host that responds to an ARP mapping request for the local host's 
address). 

Diagnostics 

duplicate IP address!! sent from ethernet address: %x:%x:%x:%x:%x:%x. 
ARP has discovered another host on the local network that responds to 
mapping requests for its own Internet address. 

Files 



/dev/inet/arp 

See Also 



arp(ADMP), ifconfig(ADMN), inet(ADMP). 
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e3A 

3C501 Ethernet Driver 

Description 

The e3A driver provides an LLI interface to a 3Com 3C501 ethemet 
card. As with other network interfaces, e3A interface must have net- 
work addresses assigned for each address family with which it is to be 
used. (Currently, only the Internet address family is supported.) 
These addresses may be set or changed with the SIOCSIFADDR ioctl. 

Files 

/dev/e3A[0-3] 

See Also 

intro(ADMP), inet(ADMP). 
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e3B 

3C503 Ethernet Driver 
Description 

The e3B driver provides an LLI interface to a 3Com 3C503 ethemet 
card. As with other network interfaces, e3B interface must have net- 
work addresses assigned for each addjress family with which it is to be 
used. (Currently, only the Internet address family is supported.) 
These addresses may be set or changed with the SIOCSBFADDR ioctl. 

Flies 

/dev/e3B[0-3] 

See Aiso 

intro(ADMP), inet(ADMP). 
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ell 

EMD convergence module 

Description 

Eli acts as a convergence module between the EMD Ethernet Driver, 
and another STREAMS driver or module. Eli provides an LLI compa- 
tible interface, which is expected by /p(ADMP). Eli must be pushed 
on the STREAM between ip and emd. 

It is expected that since the 10base5 driver is now available as a prod- 
uct, EMD will no longer be used, and eli will become obsolete. 

See Also 

strcf(SFF), ip(ADMP). 
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icmp 

Internet Control Message Protocol 

Syntax 

#include <sys/socket.h> 
#include <netinet/in.h> 

s = socket(AF_INET, SOCKRAW, proto); 

Description 

ICMP is the error and control message (or device) protocol used by IP 
and the Internet protocol family. It may be accessed through a "raw 
socket" for network monitoring and diagnostic functions. The proto 
parameter to the socket call to create an ICMP socket is obtained from 
getprotobyname . [See getprotoent{S'LlW).'\ ICMP sockets are connec- 
tionless, and are normally used with the sendto and recvfrom calls; the 
connect (SSC) call may also be used to fix the destination for future 
packets (in which case the read{S) or recv (SSC) and write (S) or 
send(SSC) system calls may be used). 

Outgoing packets automatically have an IP header prepended to them 
(based on the destination address). Incoming packets are received 
with the IP header and options intact. 

Diagnostics 

A socket operation may fail with one of the following errors returned: 

[EISCONN] when trying to estabUsh a connection on a socket 

that already has one, or when trying to send a 
datagram with the destination address specified and 
the socket already connected; 

[ENOTCONN] when trying to send a datagram, but no destination 
address is specified, and the socket has not been 
coimected; 

[ENOSR] when the system runs out of memory for an internal 

data structure; 

[EADDRNOTAVAIL] 

when an attempt is made to create a socket with a 
network address for which no network interface 
exists. 
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Files 

/dev/inet/icmp 

See Also 

send(SSC), recv(SSC), intro(ADMP), inet(ADMP), ip(ADMP). 
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inet 



Internet protocol fannily 
Syntax 



#indude <sys/types.h> 
#include <netinet/in.h> 



Description 



The Internet protocol family is a set of protocols using the Internet 
Protocol (IP) network layer and the Internet address format. The Inter- 
net family provides protocol support for the SOCK_STREAM, 
SGCK.DGRAM, and SOCK_RAW socket types; the SOCK_RAW inter- 
face provides access to the IP protocol. 



Addressing 



Internet addresses are four-byte quantities, stored in network standard 
format. The include file < sys/in.h > defines this address as a discrim- 
inated union. 

Sockets bound to the Internet protocol family use the following 
addressing structure: 

struct sockaddrjn { 

short sinjamily; 
u_short sin_port; 
struct in_addr sin_addr; 
char sin_zero[8]; 

}; 

When using sockets, the sinjamily is specified in host order, and the 
sin_port and sin_addr fields are specified in network order. 

Sockets may be created with the local address INADDR_ANY to affect 
wildcard matching on incoming messages. The address in a 
connect (SSC) or sendto [see send{SSC)\ call may be given as 
INADDR_ANY to mean "this host." Tlie distinguished address 
INADDR_BROADCAST is allowed as a shorthand for the broadcast 
address on the primary network if the first network configured sup- 
ports broadcast. 

When using the Transport Layer Interface (TLI), transport providers 
such as fcp(ADMP) support addresses whose lengths vary from eight 
to sixteen bytes. The eight byte form is the same as a sockaddrjn 
without the sinjzero field. The sixteen byte form is identical to 
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sockaddrjn. Additionally, when using TLI, the sinjamily field is 
accepted in either host or network order. 

Protocols 

The Internet protocol family is comprised of the IP transport protocol, 
Internet Control Message Protocol (ICMP), Transmission Control Pro- 
tocol (TCP), and User Datagram Protocol (UDP). TCP is used to sup- 
port the SOCK_STREAM abstraction; UDP is used to support the 
SOCK_DGRAM abstraction. A raw . interface to IP is available by 
creating an Internet socket of type SOCK_RAW. The ICMP message 
protocol is accessible from a raw socket. 

The 32-bit Internet address contains both network and host parts. It is 
frequency-encoded; the most significant bit is clear in Class A 
addresses, in which the high-order 8 bits are the network number. 
Class B addresses use the high-order 16 bits as the network field, and 
Class C addresses have a 24-bit network part. Sites with a cluster of 
local networks and a connection to the DARPA Internet may choose to 
use a single network number for the cluster; this is done by using sub- 
net addressing. The local (host) portion of the address is further subdi- 
vided into subnet and host parts. Within a subnet, each subnet appears 
to be an individual network; externally, the entire cluster appears to be 
a single, uniform network requiring only a single routing entry. Sub- 
net addressing is enabled and examined by the following ioctliS) 
commands on a datagram socket in the Internet "communications 
domain"; they have the same form as the SIOCIFADDR command. 
[See introihDMP).] 

SIOCSIFNETMASK 

Set interface network mask. The network mask 
defines the network part of the address; if it con- 
tains more of the address than the address type 
would indicate, then subnets are in use. 

SIOCGIFNETMASK 

Get interface network mask. 

See Also 

ioctl(S), socket(SSC), intro(ADMP), intro(SFF), icmp(ADMP), 
ip(ADMP), tcp(ADMP), udp(ADMP). 

Note 

The Internet protocol support is subject to change as the Internet pro- 
tocols develop. Users should not depend on details of the current 
implementation, but rather the services exported. 
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ip 

Internet Protocol 

Syntax 

#iiiclude <sys/socket.h> 
#include <netinet/in.h> 

s = socket(AF_INET, SOCKRAW, proto); 

Description 

EP is the network layer protocol used by the Internet protocol family. 
Options may be set at the IP level when using higher-level protocols 
that are based on IP (such as TCP and UDP). It may also be accessed 
through a "raw socket" or device when developing new protocols or 
special purpose applications. 

A single generic option IP_OPTIONS, is supported at the IP level, and 
may be used to provide IP options to be transmitted in the IP header of 
each outgoing packet. Options are set with setsockopt and examined 
with getsockopt . [See getsockopt (SSC).] The format of IP options to 
be sent is that specified by the IP protocol specification, with one 
exception: the list of addresses for Source Route options must include 
the first-hop gateway at the beginning of the list of gateways. The 
first-hop gateway address will be extracted from the option list and 
the size adjusted accordingly before use. IP options may be used with 
any socket type in the Internet family. 

Raw IP sockets are connectionless, and are normally used with the 
sendto and recvfrom calls; the connect (SSC) call may also be used to 
fix the destination for future packets (in which case, the read(S) or 
recv (SSC), and write (S) or send{SSC) system calls may be used). 

Jf proto is 0, the default protocol IPPROTO_RAW is used for outgoing 
packets, and only incoming packets destined for that protocol are 
received. If proto is non-zero, that protocol number will be used on 
outgoing packets and to filter incoming packets. Proto must be speci- 
fied in sockcf(SFF). 

Outgoing packets automatically have an IP header prepended to them 
(based on the destination address given and the protocol number the 
socket is created with). Incoming packets are received with IP header 
and options intact. 
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IP(ADMP) 



A socket operation may fail with one of the following errors returned: 

[EISCONN] when trying to establish a connection on a socket 

which already has one, or when trying to send a 
datagram with the destination address specified and 
the socket already connected; 

[ENOTCONN] when trying to send a datagram, but no destination 
address is specified, and tiie socket has not been 
connected; 

[ENOSR] when the system runs out of memory for an internal 

data structure; 

[EADDRNOTAVAIL] 

when an attempt is made to create a socket with a 
network address for which no network interface 
exists. 

The following errors specific to IP may occur when setting or getting 
IP options: 



[EINVAL] 
[EINVAL] 



An unknown socket option name was given. 

The IP option field was improperly formed; an 
option field was shorter than the minimum value or 
longer than the option buffer provided. 



Files 



/dev/inet/ip 
/dev/inet/rip 

See Also 



getsockopt(SSC), send(SSC), recv(SSC), sockcf(SFF), iiitro(ADMP), 
icmp(ADMP), inet(ADMP). 
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llcloop 

software loopback network interface 

Syntax 

#include <sys/socket.h> 
#include <netinet/in.h> 
struct sockaddr_in sin; 

s = socket(AF_INET, SOCKXXX, 0); 



sin.sm_addr.s_addr = htonl (INADDR_ANY); 
bind(s, (char *)&sin, sizeof(sin)); 

Description 

The llcloop mterface is a software loopback mechanism which may be 
used for performance analysis, software testing, and/or local commu- 
nication. As with other network interfaces, the loopback interface 
must have network addresses assigned for each address family with 
which it is to be used. (Currently, only the Internet address family is 
supported.) These addresses may be set or changed with the SIOCSI- 
FADDR ioctl. The loopback interface should be the first one config- 
ured, otherwise nameserver lookups for hostnames of other interfaces 
may fail. 

Files 

/dev/llcloop 

See Also 

intro(ADMP), inet(ADMP). 
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slip 



serial line IP network interface 
Description 



The slip interface is a driver that allows IP datagrams to be sent over 
normal serial lines. This is useful for connecting machines that do not 
have Ethernet hardware. As with pther network interfaces, the slip 
interface must have network addresses assigned for each address fam- 
ily with which it is to be used. (Currently, only the Internet address 
family is supported.) These addresses may be set or changed with the 
SIOCSEFADDR ioctl. 



See Also 



ifconfig(ADMN), slattach(ADMN), sldetach(ADMN), intro(ADMP), 
inet(ADMP). 
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sock 

Socket Interface Driver 

Description 

The socket driver is used to provide socket emulation to applications. 
Sockets are an alternate entry point into transport providers, such as 
/c/7(ADMP). The socket driver is a character device that acts as an 
alternate stream head, augmenting the functions of the standard 
stream head. It also provides support for miscelleanous functions such 
as select(SSC). 

FILES 

/dev/socksys 

SEE ALSO 

ifconfig(ADMN), intro(SSC), slattach(ADMN), sldetach(ADMN), 
intro(ADMP), inet(ADMP) 
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tcp 

Internet Transmission Control Protocol 

Syntax 

#include <sys/socket.h> 
#include <netinet/in.h> 

s = socket(AF_INET, SOCK_STREAM, 0); 

Description 

The TCP protocol provides reliable, flow-controlled, two-way 
transmission of data. It is a byte-stream protocol used to support the 
SOCK_STREAM abstraction. TCP uses the standard Internet address 
format and, in addition, provides a per-host collection of "port 
addresses." Thus, each address is composed of an Internet address 
specifying the host and network, with a specific TCP port on the host 
identifying the peer entit}'. 

Sockets using the tcp protocol are either "active" or "passive." 
Active sockets initiate connections to passive sockets. By default, 
TCP sockets are created active; to create a passive socket, the 
listen (SSC) system call must be used after binding the socket with the 
bind{SSC) system call. Only passive sockets may use the 
accept {SSC) call to accept incoming connections. Only active sock- 
ets may use the connect (SSC) call to initiate connections. 

Passive sockets may "underspecify" their location to match incoming 
connection requests from multiple networks. This technique, called 
"wildcard addressing," allows a single server to provide service to 
clients on multiple networks. To create a socket that listens on all net- 
works, the Internet address INADDR_ANY must be bound. The TCP 
port may still be specified at this time; if the port is not specified, the 
system will assign one. Once a connection has been established, the 
socket's address is fixed by the peer entity's location. The address 
assigned the socket is the address associated with the network inter- 
face through which packets are being transmitted and received. Nor- 
mally, this address corresponds to the peer entity's network. 

TCP supports one socket option that is set with setsockopt and tested 
with getsockopt . [See getsockopt (SSC).] Under most circumstances, 
TCP sends data when it is presented; when outstanding data has not 
yet been acknowledged, it gathers small amounts of output to be sent 
in a single packet once an acknowledgment is received. For a small 
number of clients, such as window systems that send a stream of 
mouse events that receive no replies, this packetization may cause sig- 
nificant delays. Therefore, TCP provides a boolean option. 
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TCP_NODELAY (from <netmetltcp.h> , to defeat this algorithm. The 
option level for the setsockopt call is the protocol number for TCP, 
available from getprotobyname . [See getprotoent^SiLlB).] 

Options at the IP transport level may be used with TCP; see 
/p(ADMP). hicoming connection requests that are source-routed are 
noted, and the reverse source route is used in responding. 

TCP is also available as a TLI connection-oriented protocol via the 
special file /dev/inet/tcp. TCP options are supported via the TLI 
options mechanism. 

TCP provides a facility, one-packet mode, that attempts to improve 
performance over Ethernet interfaces that cannot handle back-to-back 
packets. One-packet mode may be set by ifconfig (IM) for such an 
interface. On a connection that uses an interface for which one-packet 
mode has been set, TCP attempts to prevent the remote machine from 
sending back-to-back packets by setting the window size for the con- 
nection to the maximum segment size for the interface. 

Certain TCP implementations have an internal limit on packet size 
that is less than or equal to half the advertised maximum segment size. 
When coimected to such a machine, setting the window size to the 
maximum segment size would still allow the sender to send two pack- 
ets at a time. To prevent this, a "small packet size" and a "small 
packet threshold" may be specified when setting one-packet mode. If, 
on a cormection over an interface with one-packet mode enabled, TCP 
receives a number of consecutive packets of the small packet size 
equal to the small packet threshold, tiie window size is set to the small 
packet size. 

Diagnostics 

A socket operation may fail with one of the following errors returned: 

[EISCONN] when trying to establish a connection on a socket 

which already has one; 

[ENOSR] when the system runs out of memory for an internal 

data structure; 

[ETIMEDOUT] when a connection was dropped due to excessive 
retransmissions 

[ECONNRESET] when the remote peer forces the connection to be 
closed; 

[ECONNREFUSED] 

when the remote peer actively refuses cormection 
establishment (usually because no process is listen- 
ing to the port); 
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[EADDRINUSE] when an attempt is made to create a socket with a 
port which has already been allocated; 

[EADDRNOTAVAIL] 

when an attempt is made to create a socket with a 
network address for which no network interface 
exists. 

Files 

/dev/inet/tcp 

See Also 

ifconfig(ADMN), getsockopt(SSC), socket(SSC), intro(ADMP), 
inet(ADMP), ip(ADMP). 
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udp 



Internet User Datagram Protocol 
Syntax 



#inclu(le <sys/socket.h> 
^include <netinet/in.h> 

s = socket(AF_INET, SOCK DGRAM, 0); 

Description 



UDP is a simple, unreliable datagram protocol that is used to support 
the SOCK_DGRAM abstraction for the Internet protocol family. UDP 
sockets are coimectionless, and are normally used with the sendto and 
recvfrom calls; the connect {^SC) call may also be used to fix the des- 
tination for future packets (in which case, the recv (SSC), or read(S) 
and send(SSC), or write (S) systemAibrary calls may be used). In 
addition, UDP is available as TLI connectionless transport via the spe- 
cial file /dev/inet/udp. 

UDP address formats are identical to those used by TCP. In particular, 
UDP provides a port identifier in addition to the normal Internet 
address format. Note that the UDP port space is separate from the TCP 
port space (that is, a UDP port may not be "connected" to a TCP port). 
In addition, broadcast packets may be sent (assuming the underlying 
network supports this) by using a reserved broadcast address; this 
address is network interface-dependent. 

Options at the IP transport level may be used with UDP; see 
/p(ADMP). 



Diagnostics 



A socket operation may fail with one of the following errors returned: 

[EISCONN] when trying to establish a connection on a socket 

which already has one, or when trying to send a 
datagram with the destination address specified and 
the socket already connected; 

[ENOTCONN] when trying to send a datagram, but no destination 
address is specified, and the socket has not been 
connected; 
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[ENOSR] when the system runs out of memory for an internal 

data structure; 

[EADDRINUSE] when an attempt is made to create a socket with a 
port that has already been allocated; 

[EADDRNOTAVAIL] 

when an attempt is made to create a socket with a 
network address for which no network interface 
exists. 

Files 

/dev/inet/udp 

See Also 

getsockopt(SSC), recv(SSC), send(SSC), socket(SSC), intro(ADMP), 
inet(ADMP), ip(ADMP), RFC768. 
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vty 



pseudo terminal slave driver 

ttyp 



pseudo terminal master driver 
Description 



The ttyp and vty drivers together provide support for a device-pair 
termed & pseudo terminal. A pseudo terminal is a pair of character de- 
vices, a master device and a slave device. The slave device provides 
processes an interface identical to that described in termio{ADMF). 
However, whereas all other devices which provide the interface 
described in termio{AJyMP) have a hardware device of some sort 
behind them, the slave device has, instead, another process manipulat- 
ing it through the master half of the pseudo terminal. That is, anything 
written on the master device is given to the slave device as input and 
anything written on the slave device is presented as input on the mas- 
ter device. 

The following ioctl call applies only to pseudo terminals: 

TIOCPKT 

Enable/disable packet mode. Packet mode is enabled by specify- 
ing (by reference) a nonzero parameter and disabled by specifying 
(by reference) a zero parameter. When applied to the master side 
of a pseudo terminal, each subsequent read from the terminal will 
return data written on the slave part of the pseudo terminal pre- 
ceded by a zero byte (symbolically defined as TIOCPKT_DATA), 
or a single byte reflecting control status information. In the latter 
case, the byte is an inclusive-or of zero or more of the bits: 

TIOCPKT_FLUSHREAD 

whenever the read queue for the terminal is flushed. 

TIOCPKT_FLUSHWRITE 

whenever the write queue for the terminal is flushed. 

TIOCPKT_STOP 

whenever output to the terminal is stopped a la "S. 

TIOCPKT_START 

whenever output to the terminal is restarted. 

TIOCPKT_DOSTOP 

whenever tjstopc is "S and t_startc is "Q. 
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TIOCPKT_NOSTOP 

whenever the start and stop characters are not "SrQ. 

While this mode is in use, the presence of control status informa- 
tion to be read from the master side may be detected by a select for 
exceptional conditions. 

This mode is used by rlogin (TC) and rlogind (ADMN) to imple- 
ment a remote-echoed, locally "S/"Q flow-controlled remote login 
with proper back-flushing of output; it can be used by other similar 
programs. 

Files 

/dev/ptyp[0-fl[0-f] master pseudo terminals 

/dev/ttyp[0-f][0-f] slave pseudo terminals 

See Also 



termio(ADMP). 
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intro 

introduction to formats of files used by networking 
commands 

Description 

This section outlines the formats of various files. The C struct 
declarations for the file formats are given where applicable. Usually, 
these structures can be found in header files under the directories 
/usr/include, /usr/include/net, /usr/include/netinet, or 

/usr/include/sys. 

References of the type named(ADMN) refer to entries found in Sec- 
tion ADMN of the TCPIP Network Administrator's Reference. 



August 1,1989 INTRO-1 



ALIASES ( SFF) ALIASES ( SFF) 

aliases 

aliases file for sendmail 

Syntax 

/usr/lib/aliases 

Description 

This file describes user id aliases used by I usrilibi sendmail. It is for- 
matted as a series of lines of the form 

name: name_l, name2, name_3, . . . 

The name is the name to alias, and the name_n are the aliases for that 
name. Lines beginning with white space are continuation lines. Lines 
beginning with ' # ' are comments. 

Aliasing occurs only on local names. Loops can not occur, since no 
message will be sent to any person more than once. 

After aliasing has been done, local and valid recipients who have a 
".forward" file in their home directory have messages forwarded to 
the list of users defined in that file. 

See Also 

sendmail(ADMN) 
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hosts 

list of hosts on network 

Description 

The file /etc/hosts is a list of hosts that share the network, including 
the local host. It is referred to by programs that need to translate 
between host names and DARPA Intemet addresses when the name 
server is not being used [See named (ADMM).] Each line in the file 
describes a single host on the network and consists of three fields 
separated by any number of blanks or tabs: 

address name aliases . . . 

where 

address is the DARPA Intemet address. Unless another type 
of address is required by some host on the network, 
address should be a Class A address, which takes the 
form net. node, where net is the network number from 
/etc/networks (see networks (4)), that must between 
and 127; and node is a value which must be unique 
for each host and be between and 16777215. 

name is the official name of the host. If the host is a com- 

puter system running UNIX, it must claim this host 
name by executing hostname (TC) when it is initializ- 
mg itself. 

aliases ... is a list of alternate names for the host. Aliases can 
be used in network commands in place of the official 
name. 

It is suggested that you specify the hostname and the node name [see 
hostname (TC) and uname(C)] as aliases for one another for each ma- 
chine listed in the /etc/hosts file. 

The routines which search this file ignore comments (portions of lines 
beginning with #) and blank lines. 

An intemet address can actually take one of four forms: 

A A is a simple 32-bit integer. 

AJB A is an eight-bit quantity occupying the high-order 

byte and 5 is a 24-bit quantity occupying the remain- 
ing bytes. This form is suitable for a Class A address 
of the form net. node. 
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AM.C A is an eight-bit quantity occupying the high-order 
byte; fi is an eight-bit quantity occupying the next 
byte; and C is a 16-bit quantity occupying the remain- 
ing bytes. This form is suitable for a Class B address 
of the form llS.net.node. 

A£.CD The four parts each occupy a byte in the address. 

Example 

# Engineering network 

192.35.53.1 laizy.Lachman.COM laizy 

192.35.53.2 laidback.Lachman.COM laldback 

1 92.35.53.85 laiter.Lachman.COM laiter# Sun-3/50 [stevea] 

Files 

/etc/hosts 

See Also 

hostname(TC), uname(C), networks(SFF), inet(ADMP). 
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hosts.equiv 

list of trusted hosts 

Description 

Hosts.equiv resides in directory /etc and contains a list of trusted 
hosts. When an rlogin{\) or rcmd{\) request from such a host is made, 
and the initiator of the request is in letclpasswd, then no further vah- 
dity checking is done. That is, rlogin does not prompt for a password, 
and rsh completes successfully. So a remote user is "equivalenced" 
to a local user with the same user ID when the remote user is in 
hosts.equiv. 

The format of hosts.equiv is a list of names, as in this example: 

hostl 
host2 

A line consisting of a simple host name means that anyone logging in 
from that host is trusted. The .rhosts file has the same format as 
hosts.equiv. When user XXX executes rlogin or rcmd, the .rhosts file 
from XXX 's home directory is conceptually concatenated onto the end 
of hosts.equiv for permission checking. In the special case when the 
user is the super-user then only the /.rhosts file is checked. 

It is also possible to have two entries (separated by a single space) on 
a line of fliese files. In this case, if the remote host is equivalenced by 
the first entry, then the user named by the second entry is allowed to 
log in as anyone, that is, specify any name to the -1 flag (provided that 
name is in the /etc/pass wd file, of course). Thus 

laidbak ez 

allows ez to log in from laidbak as anyone. The usual usage would be 
to put this entry in the .rhosts file in the home directory for derek . 
Then ez may log in as derek when coming from laidbak. 

Files 

/etdhosts.equiv 
$HOMELrhost 

See Also 

rlogin(TC), rcmd(TC) 
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inetd-conf 

configuration file for inetd (internet 'super-server') 
Description 

inetd.conf is the configuration file for the inetd{S¥¥) System V 
STREAMS TCP/IP internetworking "super-server". 

The file consists of a series of single-line entries, each entry corre- 
sponding to a service to be invoked by inetd. These services are 
connection-based, datagram, or "internal". 

Internal services are those supported by the inetd program: these ser- 
vices are "echo", "discard", "chargen" (character generator), "day- 
time" (human readable time), and "time" (machine readable time, in 
the form of the number of seconds since midnight, January 1, 1900). 
All of these services are tcp based. 

Each service, including internal services, must have a valid entry in 
/etc/services(ADMN). In the case of an internal service, its name 
must correspond to the official name of the service; that is, the first 
entry in /etc/services. 

Each entry has a series of space- or tab-separated fields. (No field, 
except for the last one, may be omitted.) The fields are as follows: 

service name 

Name of a valid service in /etc/services, as described above. 

socket type 

One of "stream", "dgram", or "raw", depending on whether the 
socket type is stream, datagram, or raw [see socket {SSC)]. 

protocol 

Name of a valid protocol (for example, "tcp") specified in 
/etc/protocols( ADMN) . 

waitlnowait 

Specifies whether the socket can be made available for new con- 
nections while there is still data waiting on the socket. The value 
is always "no wait" unless it is a datagram socket. If it is a 
datagram socket, the value is usually "wait", although "nowait" is 
possible in some cases. (Note that tftpd is an exception in that it 
must have "wait" specified, and yet the socket can continue to pro- 
cess messages on the port.) 

user 

Name of the user as whom the server should run. This allows 
servers to be run with less permission than root. 
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server program 

Except in the case of internal services, full pathname of the server 
program to be invoked by inetd when a request is waiting on a 
socket. For an internal service, the value is "internal". 

server program arguments 

Arguments to the server program, starting with argv[Q], which is 
the name of the program. For an intemal service, the value is 
"internal". 

Comments are denoted by a "#" at the beginning of a line. 

The distribution inetd.conf file contains prototype entries; refer to 
these entries when editing the file. 

Example 



ftp stream 
telnet stream 
login stream 
exec stream 
finger stream 
echo stream 
discardstream 
chargen 
daytime 
time stream 
echo dgram 
discarddgram 
chargen 
daytime 
time dgram 



tcp nowait 
tcp nowait 
tcp nowait 
tcp nowait 
tcp nowait 
tcp nowait 
tcp nowait 
stream 
stream 
tcp nowait 
udp wait 
udp wait 
dgram 
dgram 
udp wait 



root 

root 

root 

root 

sync 

root 

root 

tcp 

tcp 

root 

root 

root 

udp 

udp 

root 



/etc/ftpd 

/etc/telnetd 

/etc/rlogind 

/etc/rexecd 

/etc/fingerd 

Internal 

internal 

nowait 

nowait 

internal 

Internal 

internal 

wait 

wait 

internal 



ftpd 

telnetd 

riogind 

rexecd 

fingerd 



rootinternal 
rootinternal 



rootinternal 
rootinternal 



See Also 



fingerd(ADMN), ftpd(ADMN), inetd(ADMN), lexecd(ADMN), rlog- 
in(ADMN), rshd(ADMN), tebetd(ADMN), tftpd(ADMN), 
protocols(SFF), services(SFF). 
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iocalhosts 

configuration file for sendmail 

Description 

Localhosts is a file that lists hosts that are to be treated as equivalent 
by sendmailihDMH). In the distributed configuration files, an 
equivalent host is in class S. Sendmail also looks at /etc/hosts.equiv. 

The format of localhosts is very simple. It consists of a list of host- 
names, one per line. There is no support for comments. 

Exampie 

laidbak 

laiter 

laisagna 



Files 



/usr/lib/mail/localhosts 

See ALSO 



hosts.equiv(SFF), sendmail(ADMN), sendmail(SFF), 

uucpindomain(SFF). 

Sendmail Installation and Operations Guide. 
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netrc 

login file for remote networks 

Description 

If the .netrc file exists, it will be used by//p(TC) for automatic login 
on the remote host. For each remote host, the file contains a one-line 
entry that describes the login data for the user on that host. 

An entry may consist of up to three blank-separated fields introduced 
by keywords. The keyword is followed by the literal data needed for 
login. The following keywords are available: 

machine The hostname of the machine. 

login The user login name for that host. 

password (Optional) The user's password on that host. 

NOTE: The literal password must be given in clear 
text; it is not encrypted. 

If the .netrc file includes the password feature, permissions on the file 
must be set to prohibit reading by group and others; the file will not 
otherwise take effect. 

Example 

The following example entry allows automatic login on the "admin" 
host by a user named "superuser" whose password is "open". 

machine admin login superuser password open 

Files 

$HOME/.netrc 

See Also 



ftp(TC). 

Warning 



For security reasons, use of the password feature is not recommended. 
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networks 



names and numbers for the internet 



Description 



The file /etc/networks lists networks on the internet. Each line 
describes a single network and consists of the following blank 
separated fields: 

name number aliases . . . 

where 

name is the official name of the network. All hosts on the 

internet should use the same official name for a given 
network. 



number 



aliases 



is the network number, which serves as part of the 
DARPA Internet address for each host on the internet. 
All hosts on the internet must use the same number 
for a given network. 

is a blank-separated list of local aliases for the net- 
work. 

The routines which search this file ignore comments 
(portions of lines beginning with #) and blank lines. 



Example 



# Building 1 Internet 
Lachman-Net 1 92.35.52 
LAI-TCP-Net 192.35.53 



#General 

#TCP Development 



See Also 



hosts(SFF). 



Files 



/etc/networks 
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protocois 

list of Internet protocols 

Description 

The file /etc/protocols lists known DARPA Internet protocols. Each 
line describes a single protocol and consists of the following blank 
separated fields: 

name number aliases ... 

where 

name is the official name of the protocol. 

number is the protocol number. 

aliases ... is a blank-separated list of local aliases for the proto- 
col. 

The routines which search this file ignore comments (portions of 
lines beginning with #) and blank lines. 

Protocol names and numbers are specified by the DDN Network In- 
formation Center. Do not change this file. 

Files 

/etc/protocols 

See Also 



socket(SSC), slink(ADMN), Idsocket(ADMN). 
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resoiver 

resolver configuration file 

Syntax 

/etc/resolv.conf 

Description 

The resolver configuration file contains information that is read by the 
resolver routines the first time they are invoked by a process. The file 
is designed to be human readable and contains a list of name-value 
pairs that provide various types of resolver information. 

On a normally configured system this file should not be necessary. 
The only name server to be queried will be on the local machine and 
the domain name is retrieved from the system. 

The different configuration options are: 

nameserver 

followed by the Litemet address (in dot notation) of a name server 
that the resolver should query. At least one name server should be 
listed. Up to MAXNS (currently 3) name servers may be listed; if 
more than one name server is specified, the resolver library queries 
each one in the order listed. If no nameserver entries are present, 
the default is to use the name server on the local machine. The 
algorithm used is to try a name server, and if the query times out, 
try the next, until out of name servers; then repeat trying all the 
name servers until a maximum number of retries are made. 

domain 

followed by an domain name, that is the default domain to append 
to names that do not have a dot in them. If no domain entries are 
present, the domain returned by gethostname {SUS) is used 
(everything after the first '.'). Finally, if the host name does not 
contain a domain part, the root domain is assumed. 

The name value pair must appear on a single line, and the keyword 
(e.g. nameserver) must start the line. The value follows the keyword, 
separated by white space. 
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Example 



domain Lachman.COM 
nameserver 192.35.52.1 

nameserver 192.35.52.2 



Files 



/etc/resolv.conf 

See Also 



named(ADMN), resolver(SFF), hosts(ADMN), byteorder(SLIB), 

rexec(SLIB). 

Name Server Operations Guide for BIND 
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rhosts __^____ 

remote equivalent users 

Description 

These files grant permission for remote users to use local user names 
without knowing the corresponding user passwords. This is known as 
making the remote user "equivalent" to the local user, and is con- 
venient, for example, when one person owns user names on more than 
one host. 

If a user's home directory contains a file named .rhosts, remote users 
specified in the file are equivalent to the local user. Each user specifi- 
cation in the file consists of the remote user host name and user name, 
separated by a space. (If an asterisk is substituted for either name, any 
name will match.) For security reasons, .rhosts must belong to the 
user granting the equivalence or to root. 

The file /etc/hosts.equiv is a list of remote hosts with matching-name 
equivalence. The file lists remote hosts one per line. On each host 
listed in /etc/hosts.equiv, a remote user with the same name as a local 
user is equivalent to the local user. In effect, the users are the same if 
the names are the same. 

Files 

$HOME/.rhosts 
/etc/hosts.equiv 

See Also 

rcmd(TC), rcp(TC), rlogin(TC). 

Warnings 

When a system is listed in /etc/hosts.equiv, its security must be as 
good as local security. One insecure system mentioned in 
/etc/hosts.equiv can compromise the security of an entire network. 
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sendmail-cf 

configuration file for sendmaii 

Description 

Sendmail.cf is the configuration file for the sendmaii mail router. A 
full description of this file can be found in chapter nine of the 
STREAMS TCP User's Guide. 

Files 

Aisr/lib/sendmail.cf 

See Also 

sendmail(ADMN), localhosts(SFF), uucpindomain(SFF). 
Sendmaii Installation and Operations Guide. 
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services 

list of Internet services 
Description 

The file /etc/services lists known DARPA Internet services. Each line 
describes a single service and consists of the following blank 
separated fields: 

name number /protocol aliases . . . 

where: 

name is the official name of the service. 

number is the service number. 

protocol is the name of the protocol used by the service. (See 
protocols (SFF).) 

aliases ... is a blank-separated list of local aliases for the ser- 
vice. 

The routines which search this file ignore comments (portions of lines 
beginning with #) and blank lines. 

Service names and numbers are specified by the DDN Network Infor- 
mation Center. Do not change this file unless you are familiar with 
DARPA Internet intemals. 

Files 

/etc/services 

See Also 

inetd(ADMN), inetd.conf(SFF). 
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/etc/sockcf 



socket configuration file 
Description 



/etc/sockcf contains information about the protocols that are to be 
accessed via the socket interface. TTiis file is read by 
Idsocket (ADMN) at boot time. 

/etc/sockcf contains one line per protocol which specifies the address 
family, protocol type, protocol number, flags, and STREAMS device 
for the protocol. The flags describe the behavior of the protocol. 

The format of a protocol line is: 

Family Type Protocol Flags Device 

Family can be an address family name or an integer. The following 
address family names are recognized: 



Name 


Value 


Description 


UNSPEC 





Unspecified 


UNIX 


1 


Local to host (pipes, portals) 


INET 


2 


Internetwork: TCP, UDP, etc. 


IMPLINK 


3 


Arpanet IMP addresses 


PUP 


4 


PUP protocols, e.g. BSP 


CHAOS 


5 


MIT CHAOS protocols 


NS 


6 


XEROX NS protocols 


NBS 


7 


NBS protocols 


ECMA 


8 


European Computer Manufacturers 


DATAKIT 


9 


Datakit protocols 


ccnr 


10 


ccnr protocols: X.25, etc. 


SNA 


11 


IBM SNA 


DECnet 


12 


DECnet 


DLI 


13 


Direct Data Link Interface 


LAT 


14 


LAT 


HYLINK 


15 


NSC Hyperchannel 


APPLETALK 


16 


Apple Talk 



Type can be a type name or an integer. The following type names are 
recognized: 



Name 



Value 



STREAM 


1 


DGRAM 


2 


RAW 


3 


RDM 


4 


SEQPACKET 


5 



Description 

Stream socket 
Datagram socket 
Raw protocol interface 
Reliably delivered message 
Sequenced packet stream 
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Protocol is the protocol number associated with the protocol. 

Flags is a string of flag characters describing the protocol. The recog- 
nized flag characters are: 

M This protocol supports atomic messages only. 

C Connections are required. 

A Messages contain addresses. 

R Rights can be passed with this protocol. 

P The protocol number must be bound to the stream. This is 

required to support raw IP sockets. 

/etc/sockcf may contain comments, which are delimited by '#' and 
newline. 

The standard /etc/sockcf contains the following entries: 



INET 


STREAM 


6 


C 


/dev/i net/top 


INET 


DGRAM 


17 


AM 


/dev/inet/udp 


INET 


RAW 


1 


AM 


/dev/inet/icmp 


INET 


RAW 


255 


AMP 


/dev/inet/rip 



Because of the way the kernel builds the protocol switch table, the last 
protocol specified for a type becomes the default. For this reason, it is 
important to ensure that die default protocol is the last one listed. 



Files 



/etc/sockcf 

See Also 



Idsocket(ADMN), intro(ADMP), socket(SSC). 
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/etc/strcf 

STREAMS Configuration File for STREAMS TCP/IP 
Description 

/etc/strcf contains the script that is executed by slink (SFF) to perform 
the STREAMS configuration operations required for STREAMS 
TCP/IP. 

The standard /etc/strcf file contains several functions that perform 
various configuration operations, along with a sample boot function. 
Normally, only the boot function must be modified to customize the 
configuration for a given installation. In some cases, however, it may 
be necessary to change existing functions or add new functions. 

The following functions perform basic linking operations: 

Function tp is used to set up the link between a transport provider, 
such as TCP, and IP. 

# 

# tp - configure transport provider (i.e. tcp, udp, icmp) 

# usage: tp devname 
# 

tp{ 

p = open $1 

ip = open /dev/inet/ip 

link p ip 
} 

Function linkint links the specified streams and does a sifname opera- 
tion with the given name. 

# 

# linkint - link interface to ip or arp 

# usage: linkint top bottom ifname 
# 

linkint { 

X = link $1 $2 

sifname $1 x $3 
} 

Function aplinkint performs the same function as linkint for an inter- 
face that uses the arpproc module. 

# 

# aplinkint - like linkint, but arpproc is pushed on dev 

# usage: aplinkint top bottom ifname 
# 
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aplinkint { 

push $2 arpproc 

linkint $1 $2 $3 
} 

The following functions are used to configure different types of Ether- 
net interfaces: 

Function uenet is used to configure an Ethernet interface for a cloning 
device driver that uses the unit select ioctl to select the desired inter- 
face. The interface name is constructed by concatenating the supplied 
prefix and the unit number. 

# 

# uenet - configure ethernet-type interface for cloning driver using 

# unit select 

# usage: uenet ip-fd devname ifprefix unit 
# 



uenet ■ 



ifname = strcat $3 $4 
dev = open $2 
unitseldev$4 
aplinkint $1 dev ifname 
dev = open $2 
unitsel dev $4 
arp = open /dev/inet/arp 
linkint arp dev ifname 



Function denet performs the same function as uenet, except that 
DL ATTACH is used instead of unit select . 

# 

# denet - configure ethernet-type interface for cloning driver using 

# DL_ATrACH 

# usage: denet ip-fd devname ifprefix unit 
# 



denet { 



} 



ifname = strcat $3 $4 
dev = open $2 
diattach dev $4 
aplinkint $1 dev ifname 
dev = open devname 
diattach dev $4 
arp = open /dev/inet/arp 
linkint arp dev ifname 



Function cenet is used to configure an Ethernet interface for a cloning 
device driver that uses a different major number for each interface. 
The device name is formed by concatenating the supplied device 
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name prefix and the unit number. The interface name is formed in a 
similar manner using the interface name prefix. 

# 

# cenet - configure ethemet-type interface for cloning driver with 

# one major per interface 

# usage: cenet ip-fd devprefix ifprefix unit 
# 



cenet { 



devname = strcat $2 $4 
ifname = strcat $3 $4 
dev = open devname • 
aprmkint$1 dev ifname 
dev = open devname 
arp = open /dev/inet/arp 
linkint arp dev ifname 



Function 

senet 

is used to configure an Ethernet interface for a non-cloning device 

driver. Two different device nodes must be specified for EP and ARP. 

# 

# senet - configure ethemet-type interface for non-cloning driver 

# usage: senet ip-fd ipdevname arpdevname ifname 
# 



senet { 



} 



dev = open $2 
aplinkint $1 dev $4 
dev = open $3 
arp = open /dev/inet/arp 
linkint arp dev $4 



Function senetc is like senet, except that it allows the specification of 
a convergence module to be used with the ethemet driver (e.g. for the 
3B2 emd driver). 

# 

# senetc - configure ethemet-type interface for non-cloning driver 

# using convergence module 

# usage: senetc ip-fd convergence ipdevname arpdevname ifname 
# 



senetc { 



dev = open $3 
push dev $2 
aplinkint $1 dev $5 
dev = open $4 
push dev $2 
arp = open /dev/inet/arp 
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linkint arp dev $5 
} 

Function loopback is used to configure the loopback interface. 

# 

# loopback - configure loopback device 

# usage: loopback ip-fd 
# 

loopback { 

dev = open /dev/llcloop. 

linkint $1 dev loO 
} 

Function slip is used to configure a SLIP interface. This function is 
not normally executed at boot time. Rather, the slattach (ADMN) 
command runs slink specifying slip on the command line. 

# 

# slip - configure slip interface 

# usage: slip unit 
# 



slip{ 



} 



ip = open /dev/inet/ip 
s = open /dev/slip 
ifname = strcat si $1 
unitsel s $1 
linkint ip s ifname 



Function boot is called by default when slink is executed. Normally, 
only the interfaces section and possibly the queue params section will 
have to be customized for a given installation. Examples are provided 
for the various Ethernet driver types. 

# 

# boot - boot time configuration 



# 
boot{ 



# 

# queue params 
# 

initqp /dev/inet/udp rq 81 92 40960 

initqp /dev/inet/ip muxrq 81 92 40960 rq 81 92 40960 

# 

# transport 
# 

tp /dev/inet/tcp 
tp /dev/inet/udp 
tp /dev/inet/icmp 
# 

# interfaces 
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# 

ip = open /dev/inet/ip 

senetc ip eli /dev/emdO /dev/emd1 enO 

# uenet ip /dev/abc en 

# denet ip /dev/def en 

# cenet ip /dev/giii en 

# senet ip /dev/jklO /dev/jki1 enO 
loopback ip 



Files 



/etc/strcf 

See Also 



slmk(ADMN), intro(ADMP). 
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uucpindomain 

configuration file for sendmail 

Description 

Uucpindomain is a file that lists hosts that are connected by UUCP, 
but should be treated as if they were in the local domain by 
sendmaililM). In the distributed configuration files, this type of host 
is in class L. 

The format of uucpindomain is very simple. It consists of a list of 
hostnames, one per line. There is no support for comments. 

Example 

huey 
duey 
louie 

Files 



/usr/lib/mail/uucpindomain 

See Also 



hosts.equiv(SFF), localhosts(SFF), sendmail(ADMN), sendmail(SFF). 
Sendmail Installation and Operations Guide. 



July 1 5, 1 989 UUCPINDOMAIN-1 



P/N-528-210-002 



P.O. #51027 
PAT 050 



